@tailwindcss/formsと@tailwindcss/typographyで整えるフォームと記事レイアウト

概要

Tailwind CSS でフォームや長文コンテンツを組むと、必ず一度は「素のフォーム要素がスタイリングしづらい」「Markdown から生成した HTML が無装飾で読めない」という壁にぶつかります。この2つは公式プラグインの @tailwindcss/forms と @tailwindcss/typography で解決できます。

本記事では、この2つのプラグインを実際に導入し、フォーム要素にユーティリティが効くようにする手順と、記事本文を1クラスで読みやすくする手順をハンズオンで進めます。Tailwind v3 系と v4 系の両方について書き分けます。

環境

  • Node.js 20 以上
  • Tailwind CSS v3.4 系 / v4.0 系
  • @tailwindcss/forms v0.5 系
  • @tailwindcss/typography v0.5 系

フレームワークは問いません(Vite + React、Next.js、素の HTML いずれでも同じ考え方です)。

発生した問題

1. 素のフォーム要素にユーティリティが効かない

Tailwind は Preflight(リセット CSS)でブラウザのデフォルトスタイルをかなり削ります。しかし <input> <select> <textarea> <input type="checkbox"> などは OS やブラウザ依存の見た目が残りやすく、border や rounded を付けても期待通りにならないことがあります。特にチェックボックス・ラジオ・セレクトの矢印は、ユーティリティだけでは制御しきれません。

<!-- border や rounded を付けても、チェックボックスは OS 依存の見た目のまま -->
<input type="checkbox" class="border rounded text-blue-600" />

2. Markdown 由来の HTML が無装飾で読めない

Preflight は見出しや段落のマージン、リストのマーカーも消します。CMS や Markdown パーサが吐いた HTML をそのまま表示すると、<h2> も <p> も <ul> も同じ見た目になって読めません。生成 HTML にはクラスを付けられないため、ユーティリティで個別対応するのも非現実的です。

<article>
  <h2>見出し</h2>
  <p>本文。Preflight のせいで h2 と p の区別がつかない。</p>
  <ul><li>リストのマーカーも消えている</li></ul>
</article>

原因

どちらも Tailwind の Preflight が原因です。Preflight は「ユーティリティで一から組み立てる」ことを前提に、ブラウザ標準の装飾を意図的にゼロへ寄せます。その結果、フォーム要素はユーティリティが乗る土台が揃わず、生成 HTML はクラスを付けられないので手詰まりになります。これを埋めるのが公式の2プラグインです。

対応方法

インストール

npm install -D @tailwindcss/forms @tailwindcss/typography

Tailwind v3 系の設定

// tailwind.config.js
module.exports = {
  content: ["./src/**/*.{html,js,ts,jsx,tsx}"],
  plugins: [
    require("@tailwindcss/forms"),
    require("@tailwindcss/typography"),
  ],
};

Tailwind v4 系の設定

v4 は JS 設定ファイルを使わず、CSS から @plugin で読み込むのが基本です。

/* app.css */
@import "tailwindcss";

@plugin "@tailwindcss/forms";
@plugin "@tailwindcss/typography";

クラスの使い方(form-* / prose)は v3・v4 で共通です。

実装例

forms プラグイン:2つのモード

@tailwindcss/forms には2つの戦略があります。

global モード(デフォルト): 全フォーム要素に自動でベーススタイルが当たり、以後ユーティリティで上書きできます。

class ベースモード(strategy: 'class'): form-input form-select form-checkbox などのクラスを明示したときだけスタイルが当たります。既存 CSS との衝突を避けたいプロジェクト向けです。

// class 戦略に切り替える例
plugins: [
  require("@tailwindcss/forms")({ strategy: "class" }),
],

global モードでのフォーム実装例:

<form class="max-w-md space-y-4">
  <div>
    <label class="block text-sm font-medium text-gray-700">メールアドレス</label>
    <input
      type="email"
      class="mt-1 block w-full rounded-md border-gray-300 shadow-sm
             focus:border-blue-500 focus:ring-blue-500"
      placeholder="you@example.com"
    />
  </div>

  <div>
    <label class="block text-sm font-medium text-gray-700">プラン</label>
    <select class="mt-1 block w-full rounded-md border-gray-300 shadow-sm
                   focus:border-blue-500 focus:ring-blue-500">
      <option>Free</option>
      <option>Pro</option>
    </select>
  </div>

  <label class="flex items-center gap-2">
    <input type="checkbox"
           class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" />
    <span class="text-sm text-gray-700">利用規約に同意する</span>
  </label>

  <button type="submit"
          class="w-full rounded-md bg-blue-600 px-4 py-2 text-white hover:bg-blue-700
                 focus:outline-none focus:ring-2 focus:ring-blue-500">
    送信
  </button>
</form>

チェックボックスに text-blue-600(チェック時の色)が効くこと、focus:ring-* でフォーカスリングを制御できることがポイントです。プラグイン無しだとこれらは効きません。

class 戦略を使う場合

<input type="text" class="form-input rounded-md border-gray-300" />
<select class="form-select rounded-md border-gray-300"></select>
<input type="checkbox" class="form-checkbox text-blue-600" />
<input type="radio" class="form-radio text-blue-600" />
<textarea class="form-textarea rounded-md border-gray-300"></textarea>

typography プラグイン:prose で記事本文を整える

記事を囲うラッパーに prose を付けるだけで、見出し・段落・リスト・引用・コード・テーブルまで一気に整います。

<article class="prose lg:prose-xl mx-auto">
  <h1>記事タイトル</h1>
  <p>段落。マージンも行間も自動で整う。</p>
  <h2>見出し</h2>
  <ul>
    <li>リストのマーカーが復活する</li>
  </ul>
  <blockquote>引用もスタイリングされる。</blockquote>
  <pre><code>const x = 1; // コードブロックも読みやすく</code></pre>
</article>

React で生成 HTML をレンダリングするケースでも同じです。

export function Article({ html }: { html: string }) {
  return (
    <article
      className="prose dark:prose-invert mx-auto"
      dangerouslySetInnerHTML={{ __html: html }}
    />
  );
}

prose の便利な修飾子

  • スケール: prose-sm / prose-lg / prose-xl / prose-2xl
  • 色味: prose-slate / prose-gray など
  • ダークモード: dark:prose-invert
  • 最大幅解除: max-w-none
  • element modifier: prose-headings: prose-a: prose-img: など
<article class="prose max-w-none
                prose-headings:font-bold
                prose-a:text-blue-600 prose-a:no-underline hover:prose-a:underline
                prose-img:rounded-lg prose-img:shadow">
  ...
</article>

テーマをカスタマイズする(v3)

// tailwind.config.js
theme: {
  extend: {
    typography: (theme) => ({
      DEFAULT: {
        css: {
          a: {
            color: theme("colors.blue.600"),
            "&:hover": { color: theme("colors.blue.800") },
          },
          // インラインコードの前後の backtick を消す
          "code::before": { content: '""' },
          "code::after": { content: '""' },
        },
      },
    }),
  },
},

確認方法

  1. フォームを開き、チェックボックスにチェックを入れて色が text-blue-600 になるか確認する
  2. <input> にフォーカスして focus:ring-* のリングが出るか確認する
  3. 記事ページで prose を付けた要素と付けない要素を並べ、見出し・リスト・引用の装飾差を確認する
  4. DevTools でプラグイン由来のスタイルが当たっているか確認する

prose が効かない場合、content のパスに該当ファイルが含まれておらずクラスがパージされていることが多いので、設定を見直してください。

注意点

  • forms の global モードは全フォーム要素に影響するため、既存のデザインシステムと衝突することがある。その場合は strategy: 'class' に切り替える
  • prose は max-width を付けるので、全幅にしたいときは max-w-none を忘れない
  • prose 内の要素はプラグイン側のスタイルが勝つことがある。その場合は element modifier(prose-p: など)で上書きする
  • ダークモードは dark:prose-invert が基本。独自配色ならカスタムテーマを検討する

まとめ

  • @tailwindcss/forms は Preflight で素になったフォーム要素に「ユーティリティが効く土台」を戻す(global / class の2戦略)
  • @tailwindcss/typography の prose は、クラスを付けられない生成 HTML を1クラスで読みやすくする
  • v4 では @plugin で CSS から読み込む。クラスの使い方は v3 共通
  • forms は衝突に注意、prose は max-width と element modifier を押さえれば実用十分

フォームと記事本文という「Tailwind が一番つらい2領域」は、公式プラグインで素直に解けます。

\ 最新情報をチェック /

コメントを残す

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください。