@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/formsv0.5 系@tailwindcss/typographyv0.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: '""' },
},
},
}),
},
},
確認方法
- フォームを開き、チェックボックスにチェックを入れて色が
text-blue-600になるか確認する <input>にフォーカスしてfocus:ring-*のリングが出るか確認する- 記事ページで
proseを付けた要素と付けない要素を並べ、見出し・リスト・引用の装飾差を確認する - 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領域」は、公式プラグインで素直に解けます。
