CSSで本当に苦しいのは、width: 100px が100pxにならないことではありません。
前回: Reactにできないことがある — Web Components 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。この回は新しく
~/tw-demo/を作ります。 これまでの~/react-demo/と~/web/は触りません。
CSSの回でボックスモデルをやり、レスポンシブの回でメディアクエリをやった時点で、「書き方」はもう分かっています。 それでも、書いている最中に手が止まります。
止まるのは、いつも同じ3箇所です。
1つめ。名前が思いつきません。
.box { } /* 何の箱? */
.box2 { } /* もう終わり */
.blue-box { } /* 色を変えたら嘘になる */
.card-inner-wrapper-2 { }
見た目を作りたいだけなのに、先に「この部分の呼び名」を決めさせられます。 そして名前を決めるには「この部分は何なのか」を言葉にする必要があって、まだ作っている途中なので、決まっていません。
2つめ。どこに書いたか分からなくなります。
style.css が300行を超えたあたりから、「このボタンの色は、どの行で決まっているのか」が分からなくなります。開発者ツールで見れば分かる、というのはそのとおりですが、毎回 F12 を開いて調べているなら、それはもう「読めていない」ということです。
3つめ。消していいのか分かりません。
これが一番きついところです。
.old-header { } /* 使ってる? */
.note-alt { } /* どこかで使ってる気がする */
消して確認するには、全ページを目で見るしかありません。 だから消しません。残します。 結果、CSSファイルは増える一方になります。減ることはありません。
この3つには、共通点があります。 どれも「見た目が作れない」という悩みではありません。「名前」と「置き場所」の悩みです。
CSSフレームワークが解こうとしているのは、まさにここです。 見た目を作る力を足すものではなく、名前と置き場所の管理をやめさせるものとして作られています。
この記事は「Tailwind の使い方」ではありません。「なぜこんな見た目のライブラリが広く使われているのか」と、「それでも批判され続けているのはなぜか」を、両方とも自分の手で確かめる記事です。
対象レベル: 初級 / 区分: 必修
この記事でわかること
- 素のCSSで詰まるのは「書き方」ではなく「名前」と「消せなさ」だということ。フレームワークはそこを狙っている
- CSSフレームワークには性格が正反対な2種類があること。出来合いの部品を配る型(Bootstrap)と、細かい道具を配る型(Tailwind)
content(v4では自動検出)が何をしているか。Tailwind はソースをただのテキストとして読むだけなので、bg-${color}-500は永遠に見つからない- 本番CSSが小さくなるのは「圧縮している」からではないこと。使った分しか生成していないだけ。手書きCSSより小さくなるわけではない
classが長いという批判は的外れではないこと。擁護できる部分と、できない部分がどこか- 繰り返しは
@applyではなくコンポーネントで消す理由。@applyはTailwind の利点を捨てて欠点だけ残す - 入れないほうがいい場面があること。このサイト自身が、入れていない
この記事でやること
- VMの中に
~/tw-demo/(Vite + React)を作り、Tailwind を入れる(バージョンで手順が全く違うので、まず公式を見る) - 同じ見た目のカードを、素のCSSとTailwindの両方で書いて並べる。行数ではなく「どこを直せばいいか」を比べる
npm run buildして、dist/のCSSのバイト数を実測する。クラスを増やして再ビルドし、増えた分だけ増えることを確かめるbg-${color}-500をわざと書いて壊す。なぜ壊れるかを、生成されたCSSをgrepして確認する- 繰り返しをコンポーネントに切り出して消す(Reactの回の回収)
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| CSSフレームワーク | あらかじめ用意されたCSSを読み込んで使う仕組み。自分でCSSを書く量を減らすためのもの |
| ユーティリティクラス | 1つのことだけをするクラス。p-4 は「内側の余白を1rem」、flex は「display:flex」。それ以上のことはしない |
| ユーティリティファースト | 見た目のほとんどをユーティリティクラスの組み合わせで作るやり方。Tailwind がこれ |
| コンポーネントクラス | .btn .card のように、部品ひとかたまり分の見た目を1つの名前に入れたクラス。Bootstrap がこれ |
| Preflight | Tailwind が最初に流し込むリセットCSS。ブラウザ既定の見た目(見出しの大きさ、リストの点など)をいったん全部消す |
| パージ / ツリーシェイキング(CSSの) | 使われていないCSSを出力から落とすこと。ビルドツールの回でJSについてやったものの、CSS版 |
@apply | Tailwind の機能で、ユーティリティクラスをまとめて自分のクラスに入れるもの。後半で「使わない」という話をします |
① まず、素のCSSで詰まるところを再現する
言葉で説明するより、1回書いたほうが早いです。
VMの中で、素のHTMLを置いてある ~/web/ に、確認用のファイルを1枚作ります。Vite も React も要りません。
中身はこれだけです。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>名前を付ける練習</title>
<style>
.?????? { }
</style>
</head>
<body>
<div>
<h2>保存しました</h2>
<p>変更は次回の読み込みから反映されます。</p>
<button>閉じる</button>
</div>
</body>
</html>
この <div> に、クラス名を1つ付けてください。
手が止まったなら、それがこの記事の出発点です。
.box→ 何の箱か分からない.message→ あとで警告用にも使うかもしれない。そのとき.message-errorが要る.save-message→ 「保存しました」以外に使えなくなる.card→ 良さそうだが、この先ページ内に.cardが5種類できたときに破綻する
どれも間違いではありません。 ですが、どれを選んでも、あとで後悔する可能性が残ります。 そして後悔したときには、HTMLとCSSの両方を直すことになります。
「BEM を使えば解決する」と言われることがあります。 BEM(
.card__title--largeのような命名規則)は、名前の付け方を統一するものです。「名前を考える」という作業そのものは消えません。 消えるのは「付け方がバラバラになる」という別の問題です。
このファイルは、もう使いません。 消しておいて構いません。
② CSSフレームワークには2種類ある
「CSSフレームワーク」と一括りにされますが、中身は正反対の2派です。ここを混ぜて理解すると、両方が分からなくなります。
| 出来合いの部品型 | 細かい道具型 | |
|---|---|---|
| 代表 | Bootstrap / Bulma / Foundation | Tailwind CSS / UnoCSS |
| 配っているもの | .btn .card .navbar — 部品まるごと | p-4 flex text-sm — 1プロパティ分 |
| 1クラスの意味 | 「これはボタンです」 | 「内側の余白を1rem」 |
| 書き始めたとき | 速い。 クラスを1つ付ければ形になる | 遅い。 何個も並べないと形にならない |
| 既定のデザイン | ある。 何もしなくても「Bootstrapの見た目」になる | ほぼ無い。 色も余白も自分で決める |
| 少し違う見た目にしたいとき | .btn を上書きする戦いになる | クラスを1つ差し替えるだけ |
| 同じサイトが量産される | しやすい(見ればBootstrapと分かる) | しにくい |
| HTMLの見た目 | 短い(class="btn btn-primary") | 長い(class="rounded-md bg-blue-600 px-3 py-1.5 …") |
| CSSを知らなくても | ある程度は書ける | 書けない。 CSSの知識がそのまま要る |
この表の最後の行が、この記事の結論に効いてきます。
Bootstrap は「CSSを書く量を減らす」。 Tailwind は「CSSを書く場所を変える」。
Tailwind は、CSSを書かなくてよくする道具ではありません。 CSSを、別ファイルではなく HTML のその場に書けるようにした道具です。p-4 は padding: 1rem; の別名でしかありません。書く量はむしろ変わりません。
変わるのは、①で詰まった3つです。
| ①で詰まったこと | Tailwind ではどうなるか |
|---|---|
| 名前が思いつかない | 名前を付けない。 決める作業自体が消える |
| どこに書いたか分からない | そのタグに書いてある。 探さない |
| 消していいか分からない | タグを消せばCSSも消える。 他に影響しない |
ここだけを狙って作られています。 逆に言えば、この3つで困っていないなら、入れる理由はありません。 ⑧でその話をします。
どちらが優れているか、という話ではありません。 既定のデザインが欲しいなら Bootstrap、既定のデザインが邪魔なら Tailwindです。「デザインを自分で決めたい」ときに Bootstrap を選ぶと、上書きとの戦いになります。
③ Tailwind を Vite プロジェクトに入れる
先に読んでほしいこと
Tailwind は、メジャーバージョンで導入手順が完全に変わりました。
ネットに出てくる記事の大半は v3 向けです。v3 の手順を v4 でやると動かず、逆もまた動きません。 そしてどちらのエラーメッセージも、原因を教えてくれません。
必ず公式のインストール手順を開いて、そこに書いてある手順でやってください。 この記事の手順も、読んだ時点で古くなっている可能性があります。
違いを表にします。 自分がどちらを見ているかを判断するために使ってください。
| v3 まで | v4 から | |
|---|---|---|
| 入れるパッケージ | tailwindcss postcss autoprefixer | tailwindcss @tailwindcss/vite |
| 設定ファイル | tailwind.config.js(npx tailwindcss init -p で作る)と postcss.config.js | 無し。 vite.config.js にプラグインを1行 |
| CSSに書く行 | @tailwind base; @tailwind components; @tailwind utilities; の3行 | @import "tailwindcss"; の1行 |
| 対象ファイルの指定 | content: [...] に自分で書く | 自動検出。 足すときだけ @source |
| 色や余白の変更 | tailwind.config.js の theme.extend | CSSの @theme |
この記事は v4 の手順で書きます。
プロジェクトを作る
VMの中で作ります。ビルドツールの回と同じ手順です。
--が2つ並んでいるのは打ち間違いではありません。 「ここから先は npm ではなく create-vite への引数だ」という区切りです(npmの回)。
Tailwind を入れる
2つ入ります。
| パッケージ | 役割 |
|---|---|
tailwindcss | 本体。 クラス名からCSSを作る部分 |
@tailwindcss/vite | Vite に組み込むための繋ぎ。 ビルドの途中でソースを読ませる |
vite.config.js(丸ごと置き換え)
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import tailwindcss from '@tailwindcss/vite'
export default defineConfig({
plugins: [react(), tailwindcss()],
})
plugins の配列に1つ足しただけです。ビルドツールの回で「Vite は本体だけでは何もしない、プラグインが仕事をする」と書いたのが、そのまま出てきています。
src/index.css(丸ごと置き換え)
@import "tailwindcss";
この1行だけです。 元々書いてあったCSSは、全部消してください。
src/App.jsx(丸ごと置き換え)
Vite の React テンプレートには App.css の読み込みとロゴが入っています。邪魔になるので、いったん空にします。
function App() {
return (
<h1 className="text-3xl font-bold text-blue-600">Tailwind が効いています</h1>
);
}
export default App;
動かして確認する
ホストの Windows のブラウザで http://192.168.226.50:5173/(IPは自分の値に。分からなければ VM の中で ip a)を開きます。
確認するのは1点だけです。
| 見えたもの | 判定 |
|---|---|
| 大きい・太い・青い文字 | 効いています |
| 黒くて普通の見出し | 効いていません。 ③を最初からやり直してください |
「大きい黒文字」だった場合に注意してください。
<h1>はブラウザ既定でも大きく太くなります。判定は「青いかどうか」で行ってください。 色は Tailwind でしか付けていません。
[スクリーンショット: 01_tailwind導入確認.png] ホストのブラウザで、青い太字の見出しが表示されている画面を撮ってください。
content / 自動検出が何をしているか
ここが、この記事で一番大事な理屈です。
Tailwind は、あなたのプロジェクトのソースファイルを、ただのテキストとして先頭から読みます。 そして、知っているクラス名のパターンに一致する文字列を拾い、それに対応するCSSだけを作ります。
JavaScript を実行しません。 構文を解析して意味を取るわけでもありません。 文字列の一致を見ているだけです。
v3 では、その「読むファイル」を自分で指定していました。
// tailwind.config.js(v3)
content: ["./index.html", "./src/**/*.{js,jsx}"],
v4 では、.gitignore を見ながらプロジェクトを自動で走査します。 だから設定を書かなくても動きます。足したいときだけ、CSSに @source "../packages/ui"; のように書きます。
この仕組みから、2つの結果が直接出てきます。
1つめ。使っていないクラスのCSSは、そもそも生成されません。 ⑥で実測します。
2つめ。組み立てたクラス名は、絶対に見つかりません。
// ❌ 動かない
<div className={`bg-${color}-500`}>
bg-red-500 という文字列は、ソースのどこにも存在しません。 実行時に初めて出来上がります。Tailwind は実行しないので、永遠に気づけません。 ④の最後で実際に壊します。
④ 同じ見た目を、両方で書いて並べる
ここが山場です。
①で名前を付けられなかった、あのカードを、素のCSSと Tailwind の両方で作ります。見た目は完全に同じにします。
素のCSSで書く
src/plain.css(新規)
.card {
max-width: 24rem;
padding: 1rem;
border: 1px solid #e5e7eb;
border-radius: 0.5rem;
background: #ffffff;
box-shadow: 0 1px 2px rgb(0 0 0 / 0.05);
}
.card__title {
margin: 0 0 0.25rem;
font-size: 1rem;
font-weight: 600;
color: #111827;
}
.card__body {
margin: 0 0 0.75rem;
font-size: 0.875rem;
color: #4b5563;
}
.card__actions {
display: flex;
justify-content: flex-end;
gap: 0.5rem;
}
.card__button {
padding: 0.375rem 0.75rem;
border: 0;
border-radius: 0.375rem;
background: #2563eb;
color: #ffffff;
font-size: 0.875rem;
cursor: pointer;
}
.card__button:hover {
background: #1d4ed8;
}
src/PlainCard.jsx(新規)
import "./plain.css";
function PlainCard() {
return (
<div className="card">
<h2 className="card__title">保存しました</h2>
<p className="card__body">変更は次回の読み込みから反映されます。</p>
<div className="card__actions">
<button className="card__button">閉じる</button>
</div>
</div>
);
}
export default PlainCard;
Tailwind で書く
src/TwCard.jsx(新規)
function TwCard() {
return (
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">保存しました</h2>
<p className="mb-3 text-sm text-gray-600">変更は次回の読み込みから反映されます。</p>
<div className="flex justify-end gap-2">
<button className="cursor-pointer rounded-md bg-blue-600 px-3 py-1.5 text-sm text-white hover:bg-blue-700">
閉じる
</button>
</div>
</div>
);
}
export default TwCard;
src/App.jsx(丸ごと置き換え)
import PlainCard from "./PlainCard.jsx";
import TwCard from "./TwCard.jsx";
function App() {
return (
<div className="flex flex-col gap-6 p-8 md:flex-row">
<div>
<p className="mb-2 text-xs text-gray-500">素のCSS</p>
<PlainCard />
</div>
<div>
<p className="mb-2 text-xs text-gray-500">Tailwind</p>
<TwCard />
</div>
</div>
);
}
export default App;
ブラウザで見てください。 左右で、区別がつかないはずです。
md:flex-rowはレスポンシブの回でやったメディアクエリです。狭いときは縦(flex-col)、md(768px)以上で横(flex-row)。md:を付けると@media (min-width: 768px)の中に入る、というだけの仕組みです。モバイルファーストで書くという原則も、そのまま引き継がれています。ブラウザの幅を縮めて確かめてください。
[スクリーンショット: 02_同じ見た目の比較.png] 素のCSS版とTailwind版のカードが並んで、同じ見た目になっている画面を撮ってください。
1対1で対応している
Tailwind のクラスは、暗記するものではありません。 CSSのプロパティと1対1で並んでいるだけです。
| 素のCSS | Tailwind |
|---|---|
max-width: 24rem | max-w-sm |
padding: 1rem | p-4 |
border-radius: 0.5rem | rounded-lg |
background: #ffffff | bg-white |
font-size: 0.875rem | text-sm |
display: flex | flex |
justify-content: flex-end | justify-end |
gap: 0.5rem | gap-2 |
:hover { background: … } | hover:bg-blue-700 |
p-4 の 4 は「4px」ではありません。 0.25rem × 4 = 1rem です。この刻みが決まっていることが、実は一番の効能かもしれません。素のCSSだと、ある場所は 12px、別の場所は 0.8rem、また別の場所は 15px になりがちです。選択肢が有限だと、揃います。
行数はほぼ同じ。見るべきはそこではない
素のCSS版は、CSS 36行 + JSX 13行。 Tailwind版は、JSX 15行。
「行数が減った」と言いたくなりますが、それは本質ではありません。 実際、className の中身を1行と数えれば、書いている文字数はほとんど同じです。p-4 と書くか padding: 1rem; と書くかの違いしかありません。
比べるべきは「変更を頼まれたときに、どこを開くか」です。
| 頼まれたこと | 素のCSS | Tailwind |
|---|---|---|
| このカードの余白を広げて | plain.css を開き、.card を探し、他にも .card を使っている場所が無いか確認してから直す | JSXの p-4 を p-6 に。 いま見ている行 |
| このカードだけ広げて(他は今のまま) | .card--wide を新設し、名前を決め、HTMLにも足す | p-4 を p-6 に。 それだけ |
| 全部のカードを広げて | .card を1箇所直せば終わり | カードを書いた全箇所を直す ←負け |
.card__body はもう使ってない? | 全ファイルを grep して確認。 不安なので残す | タグを消せば消える。 判断が要らない |
| 別ページで急にこのカードが崩れた | どこかの .card 上書きを、詳細度も含めて探す | そのタグの className に書いてあるものが全部。 他は無い |
5つのうち4つは Tailwind が勝ち、1つは完敗しています。
そして、その1つ(全部のカードを直したい)が、Tailwind への最大の批判です。⑦で、これに答えます。
壊してみる — 組み立てたクラス名
③の理屈を、実際に確かめます。 TwCard.jsx のボタンを、一時的にこうしてください。
function TwCard({ color = "blue" }) {
return (
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">保存しました</h2>
<p className="mb-3 text-sm text-gray-600">変更は次回の読み込みから反映されます。</p>
<div className="flex justify-end gap-2">
<button className={`cursor-pointer rounded-md bg-${color}-600 px-3 py-1.5 text-sm text-white`}>
閉じる
</button>
</div>
</div>
);
}
export default TwCard;
ブラウザを見てください。 ボタンの背景が消えます。 文字は白のままなので、白地に白文字になり、ボタンが見えなくなります。
エラーは1つも出ません。 Console にも、ターミナルにも、何も出ません。
理由は③のとおりです。 ソースに
bg-blue-600という文字列がありません。 あるのは`bg-${color}-600`という別の文字列です。Tailwind はテキストを読んでいるだけなので、これをbg-blue-600に組み立てて考えることはできません。
[スクリーンショット: 03_動的クラス名で消える.png] Tailwind版のボタンの背景色が消えて、白地に白文字になっている画面を撮ってください。
正しいやり方は、「完全なクラス名を、ソースのどこかに書いておく」ことです。
const COLORS = {
blue: "bg-blue-600 hover:bg-blue-700",
red: "bg-red-600 hover:bg-red-700",
};
function TwCard({ color = "blue" }) {
// ...
<button className={`cursor-pointer rounded-md px-3 py-1.5 text-sm text-white ${COLORS[color]}`}>
この書き方なら動きます。 bg-blue-600 という文字列が、ソースにそのまま存在しているからです。JavaScript の意味としては上と同じ「動的」ですが、Tailwind にとってはテキストの有無だけが問題です。
確認したら、④の元の TwCard.jsx に戻してください。 ⑥で使います。
⑤ なぜ class="p-4 bg-blue-500" が汚く見えるのか
Tailwind を初めて見た人の反応は、ほぼ全員同じです。
「これ、
style属性に直接書いているのと何が違うんですか」
この批判は、的外れではありません。 正しい部分があります。 順番に見ます。
批判の側 — 正しいこと
1. HTMLとCSSの分離という原則に、明確に反している
CSSの回で、「タグに直接 style を書くな、別ファイルにしろ」と書きました。Tailwind は、その方針を真っ向から否定します。 「別ファイルにしろ」と言っておきながら、その逆をやっているわけです。気持ち悪いのは当然です。
2. HTMLが読みにくくなる。これは事実
<button class="inline-flex items-center justify-center gap-2 rounded-md bg-blue-600 px-3 py-1.5 text-sm font-medium text-white shadow-sm transition hover:bg-blue-700 focus-visible:outline-2 focus-visible:outline-offset-2 disabled:opacity-50">
この1行を「読みやすい」と言う人はいません。 横に長すぎて、タグの構造が見えなくなります。 擁護のしようがありません。
3. .card のほうが「意味」が読める
class="card" を見れば「これはカードだ」と分かります。 class="max-w-sm rounded-lg border …" を見ても、「角が丸い箱」だとしか分かりません。 HTMLは意味を与えるものだというHTMLの回の話と、噛み合っていません。
4. 差分(diff)が読みにくい
クラスを1つ足しただけでも、Git の差分では「その1行がまるごと変わった」ように見えます。 レビューがしづらくなります。
5. Tailwind を知らない人が、そのHTMLを読めない
素のCSSなら、CSSを知っている人なら誰でも読めます。 Tailwind の記法は、Tailwind を知っている人にしか読めません。
擁護の側 — 反論できること
1. 「関心の分離」は、実は達成されていなかった
これが一番強い反論です。
HTMLとCSSを別ファイルにしても、両者は密結合のままです。.card__title のクラス名をHTMLで変えれば、CSSは壊れます。CSSで .card を消せば、HTMLの見た目は壊れます。
ファイルが分かれていることと、関心が分かれていることは、別です。 実際に分かれていたのは「関心」ではなく「技術」でした。片方を直すともう片方も直すのなら、それは1つの関心事です。
2. style 属性とは、決定的に違う点が3つある
style="padding:16px" | class="p-4" | |
|---|---|---|
:hover や @media が書けるか | 書けない(これが致命的) | 書ける(hover: md:) |
| 値が自由か | 自由。 13px も #3a7fd5 も書ける | 制限がある。 決められた刻みの中から選ぶ |
| 同じ指定が10箇所にあったら | 10回分のバイト数がHTMLに乗る | CSSは1個。 HTMLに載るのは短い名前だけ |
特に1行目が大きいです。 インラインスタイルではレスポンシブもホバーも書けないので、「同じもの」ではありません。
3. 名前を付ける作業が、本当に消える
①で手が止まった理由が、そもそも発生しません。 これは体感してみないと分かりませんが、「作りながら考える」ときの速さが、明確に違います。
4. 並び順は機械が揃えられる
「クラスの順番がバラバラで読めない」という批判には、答えがあります。 公式の Prettier プラグイン(prettier-plugin-tailwindcss)が、保存のたびに毎回同じ順番に並べ替えます。 ESLintとPrettierの回で入れた仕組みが、そのまま効きます。人が揃える必要はありません。
で、どちらが正しいのか
両方正しい、というのが正直なところです。
「読みにくい」という批判は、事実として認めるしかありません。 Tailwind が主張しているのは「読みにくくない」ではなく、「読みにくさと引き換えに、名前と削除の問題が消える」という取引です。
その取引が得かどうかは、プロジェクトによって違います。
| 得になりやすい | 損になりやすい |
|---|---|
| 画面が多く、見た目がそれぞれ違う | 同じ部品を繰り返すだけ |
| コンポーネントの仕組みがある(React など) | 素のHTMLを手で書く |
| デザインを自分で決める | 既定のデザインをそのまま使いたい |
| CSSファイルが増え続けて困っている | CSSが200行で収まっている |
このサイト(obmes.com)は右列です。⑧で書きます。
⑥ 本番のCSSが小さくなる仕組み — 実測する
Tailwind の説明でよく見る「本番ではCSSが小さくなる」を、実際に測ります。
まずビルドして測る
開発サーバーを Ctrl+C で止めてから実行します。
この記事の実機では、こう出ました。
-rw-rw-r-- 1 ubuntu ubuntu 12784 Sep 10 11:02 index-4c1f8ad2.css
-rw-rw-r-- 1 ubuntu ubuntu 189342 Sep 10 11:02 index-b7e39c04.js
CSSは 12,784 バイト(約12.5KB)でした。gzip 後も測ります。 実際に通信で流れるのはこちらです。
3418
約3.3KB です。
使っていないクラスは、本当に入っていないのか
grep で直接確かめます。 使っていない色を探します。
0
1つも入っていません。 bg-lime-300 は Tailwind に存在するクラスですが、ソースに書いていないので、生成されていません。
ついでに、使っているものが入っていることも確かめます。
1
増やすと、増える
「使った分だけ」を確かめるために、わざとクラスを大量に増やします。
src/Sandbox.jsx(新規)
const CLASSES = [
"bg-lime-300", "bg-amber-400", "bg-rose-500", "bg-teal-600",
"text-lime-900", "text-amber-900", "text-rose-50", "text-teal-50",
"rounded-none", "rounded-sm", "rounded-xl", "rounded-full",
"border-2", "border-4", "border-dashed", "border-dotted",
"p-1", "p-2", "p-3", "p-5", "p-6", "p-8", "p-10", "p-12",
"m-1", "m-2", "m-3", "m-5", "m-6", "m-8",
"tracking-tight", "tracking-wide", "leading-tight", "leading-loose",
"italic", "uppercase", "lowercase", "underline",
"opacity-25", "opacity-50", "opacity-75",
"shadow-md", "shadow-lg", "shadow-xl", "shadow-2xl",
"rotate-3", "scale-95", "blur-sm",
];
function Sandbox() {
return (
<div className="flex flex-wrap gap-1">
{CLASSES.map((c) => (
<span key={c} className={`${c} px-2 py-1 text-xs`}>
{c}
</span>
))}
</div>
);
}
export default Sandbox;
App.jsx に import Sandbox from "./Sandbox.jsx"; を足し、<Sandbox /> を置いてから、ビルドし直します。
実機ではこうなりました。
-rw-rw-r-- 1 ubuntu ubuntu 14106 Sep 10 11:09 index-9d2a71ef.css
3801
12,784 → 14,106 バイト。 50個弱のクラスを足して、1.3KB 増えました。
1
さっき無かったものが、入りました。
ここで、③の理屈がもう一度効いています。
CLASSESは JavaScript の配列で、classNameには{c}という変数で渡しています。 それでも動きます。"bg-lime-300"という完全な文字列が、ソースファイルの中にそのまま書いてあるからです。Tailwind はテキストを読んでいるだけなので、それが配列の中だろうと関係ありません。 ④で壊れたbg-${color}-600との違いは、「JavaScriptとして動的かどうか」ではなく、「ソースに完全な文字列があるかどうか」だけです。
[スクリーンショット: 04_ビルドサイズの比較.png] ls -l の結果を2回並べて、CSSのバイト数が増えていることが分かる画面を撮ってください。
元に戻す
App.jsx の import と <Sandbox /> も消してください。 消さないとビルドが失敗します。
「小さくなる」の意味を、正確にする
ここを誤解している記事が非常に多いので、はっきり書きます。
Tailwind の出力が小さいのは、「圧縮が上手い」からではありません。 使ったクラスのCSSしか、最初から生成していないだけです。削っているのではなく、作っていません。
そして、もっと大事なことです。
手書きのCSSより小さくなるわけではありません。
④で書いた plain.css は、圧縮前で1KBもありません。 一方、Tailwind 版は 12.5KB です。 10倍以上、Tailwind のほうが大きいのです。
内訳はこうなっています。
| 中身 | だいたいの大きさ | 何か |
|---|---|---|
| Preflight(リセットCSS) | 大半 | ブラウザ既定の見た目を消す部分。1クラスも使わなくても入る |
| テーマ変数(色・余白の定義) | 数KB | --color-blue-600 のようなCSS変数の一覧 |
| 実際に使ったユーティリティ | 数百バイト〜 | ここだけが、書いた分に比例して増える |
つまり、Tailwind には「固定費」があります。 ページが小さいほど、割に合いません。
「小さくなる」が本当になるのは、規模が大きくなってからです。 手書きCSSは、画面が増えるほど(消せないクラスが溜まるので)増え続けます。 Tailwind は、画面が増えても(同じ
p-4を何度使っても出力は1個なので)ほとんど増えません。 どこかで逆転します。 その手前で入れると、ただ重くなるだけです。
⑦ 繰り返しは、コンポーネントで消す
④の表で、Tailwind が完敗した項目が1つありました。
「全部のカードを広げて」→ カードを書いた全箇所を直す
これが「Tailwind はDRY原則に反する」という批判の中身です。同じクラスの羅列を、何十箇所にもコピーすることになります。
答えは、Tailwind の機能ではありません。 コンポーネントの回でやったこと、そのものです。
繰り返しを作ってから、消す
src/App.jsx を、一度こうしてください。 わざと3回コピーします。
function App() {
return (
<div className="flex flex-col gap-4 p-8">
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">保存しました</h2>
</div>
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">送信しました</h2>
</div>
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">削除しました</h2>
</div>
</div>
);
}
export default App;
これは、確かにひどいです。 余白を変えるには3箇所直す必要があり、1箇所忘れれば静かにずれます。
消し方は、こうです。
src/Card.jsx(新規)
function Card({ title }) {
return (
<div className="max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm">
<h2 className="mb-1 text-base font-semibold text-gray-900">{title}</h2>
</div>
);
}
export default Card;
src/App.jsx(丸ごと置き換え)
import Card from "./Card.jsx";
function App() {
return (
<div className="flex flex-col gap-4 p-8">
<Card title="保存しました" />
<Card title="送信しました" />
<Card title="削除しました" />
</div>
);
}
export default App;
クラスの羅列は、Card.jsx の中の1箇所だけになりました。余白を変えるなら、開くファイルは1つです。
④の表で「完敗」だった行が、これで消えました。 しかも、素のCSSのときのような不安がありません。
Cardを消せば、その見た目は完全に消えます。.cardを消すときの「どこかで使っていないか」という不安が、そもそも発生しません。
@apply に逃げてはいけない
Tailwind には、これを解決するように見える機能があります。
/* ❌ やらない */
.card {
@apply max-w-sm rounded-lg border border-gray-200 bg-white p-4 shadow-sm;
}
「クラス名が長いのが嫌」「HTMLが汚い」と思った人が、必ず最初にたどり着く書き方です。そして、ほぼ必ず後悔します。
何が起きるか、①に戻って考えてください。
| ①の悩み | @apply を使うと |
|---|---|
| 名前が思いつかない | .card という名前を、また考えることになった |
| どこに書いたか分からない | CSSファイルに戻った。また探すことになった |
| 消していいか分からない | .card を消していいか、また分からなくなった |
@applyは、Tailwind の利点を全部捨てて、欠点(記法が独特で他人に読めない)だけを残します。 得られたのは「HTMLが短く見える」ことだけです。それなら、最初から素のCSSを書いたほうが、他人に読めるぶんマシです。
Tailwind の作者自身も、この使い方を勧めていません。 繰り返しを消す道具は、CSS側ではなくコンポーネント側にあります。
@applyを使いたくなったら、それは「コンポーネントに切り出す時が来た」という合図だと考えてください。
例外はあります。 <Card> のようなコンポーネントを作れない場所 — 例えば Markdown から生成される本文 や、サードパーティのHTMLに当てる場合 です。コンポーネントという逃げ道が本当に無いときだけ、検討する価値があります。
⑧ 使わない、という選択
ここまで読んで「良さそうだ」と思ったかもしれません。 それでも、このサイトは Tailwind を使っていません。
理由を正直に書きます。
1. このサイトは、CSSが200行くらいで足りている
⑥で測ったとおり、Tailwind には12KBほどの固定費があります。 見た目のバリエーションが少ないサイトでは、その固定費を回収できません。 ①の3つの悩みも、200行では発生しません。
2. ビルド工程が前提になる
Tailwind を使うには、ソースを走査してCSSを生成する工程が要ります。 つまり Vite のようなビルドツールが前提です。
~/web/index.html のような、素のHTMLをそのまま置くやり方とは、相性が悪いです。
「CDNから読み込むだけで使える」という記事を見かけますが、あれは開発中に試すためのものです。ブラウザ上でCSSを生成するので重く、公式も本番では使わないように書いています。 本番で使うなら、ビルド工程は避けられません。
3. コンポーネントの仕組みが無いと、⑦の答えが使えない
Tailwind の弱点(繰り返し)を消す方法は、コンポーネント化でした。それが無い環境で使うと、弱点だけが残ります。 WordPress のテーマを手で書く、という状況がまさにこれです。
判断の基準は、これだけです。
「クラス名が思いつかない」「消していいか分からない」で、実際に時間を失っているか。 失っていないなら、入れる理由はありません。
流行っているから入れる、は理由になりません。 ⑤で見たとおり、明確なデメリットと引き換えの取引です。払うものがあるのに、得るものが無いなら、ただの損です。
⑨ やりすぎない — CSSを学ばなくていい理由にはならない
最後に、一番言いたいことです。
Tailwind を入れても、CSSの知識は1ミリも減りません。
<div class="flex items-center justify-between gap-4">
この1行を書くために、何を知っている必要があるか。
| クラス | 知っている必要があること |
|---|---|
flex | Flexbox という仕組みがあること(CSSの回) |
items-center | 交差軸という概念。align-items が縦方向とは限らないこと |
justify-between | 主軸という概念。flex-direction を変えると意味が変わること |
gap-4 | gap が Flexbox と Grid で使えること |
全部、素のCSSの知識です。 名前が短くなっただけです。
items-centerが効かないとき、Tailwind のドキュメントを読んでも解決しません。align-itemsが何をするものかを知らないと、直せません。
同じことが、⑤で見た批判にも当てはまります。
hover:bg-blue-700が効かない → 擬似クラスを理解していないmd:flex-rowが効かない → メディアクエリとモバイルファーストを理解していない- 要素が思った場所に行かない → ボックスモデルと
positionを理解していない
Tailwind は、CSSの「入力方法」を変える道具です。CSSの代わりではありません。
順番を間違えないでください。 CSSを知らないまま Tailwind を覚えると、「動くまでクラスを足す」ことになります。 これはCSSの回で「使うな」と書いた
!importantの連打と、構造がまったく同じです。 仕組みが分かっていないまま、症状を上から塗り潰しているからです。
そして、やりすぎないこと。
Tailwind を入れると、className を長くすることに熱中しがちです。 止めてください。
- 20個クラスが並んだら、コンポーネントに切り出す合図(⑦)
- Tailwind に無いことを無理にやらない。 複雑なアニメーションや、独特なグリッドは、普通にCSSファイルに書けばいい
- Tailwind と素のCSSは併用できます。 ④で
plain.cssと Tailwind を同じページで動かしたとおりです。全部をどちらかに寄せる必要はありません
つまずいたところ
npm run dev は動くのに、どのクラスも効かない → vite.config.js にプラグインを足していません。 ③の tailwindcss() を確認してください。import だけ書いて plugins に入れ忘れるのがよくあります。
Cannot apply unknown utility class / @tailwind でエラーになる → v3 の手順と v4 が混ざっています。 src/index.css に @tailwind base; の3行を書いていませんか。v4 では @import "tailwindcss"; の1行だけです。逆に、v3 を使っているなら3行のほうが正しいです。公式のインストール手順を見て、どちらか片方に揃えてください。
npx tailwindcss init -p が command not found / エラーになる → v4 には init コマンドがありません。 設定ファイルを作る必要が無いためです。その手順を書いている記事は v3 向けです。
入れた瞬間、既存のページの見出しが小さくなり、リストの点が消えた → Preflight です。壊れていません。 Tailwind は最初にブラウザ既定の見た目を全部消します。 ブラウザごとの差をなくすためです。<h1> が普通の文字サイズになるのは正常で、大きさは自分で text-3xl のように指定します。 → 既存サイトに後から入れると、これで全部の見た目が飛びます。 既存サイトへの後付けが難しい理由の大半がこれです。
クラスが効かないので !important を付けたくなった → 止めてください。 CSSの回と同じ理由です。Tailwind でこれをやると、その要素だけ特別扱いになり、あとで誰も直せなくなります。 効かない原因(Preflight か、クラス名の綴りか、生成されていないか)を先に特定してください。
bg-red-500 と書いたのに、背景が付かない → 綴りを疑う前に、grep "bg-red-500" dist/assets/*.css で「生成されているか」を確認してください。生成されていないなら、ソースに完全な文字列が無いということです(④)。生成されているなら、別の指定に負けています。
開発中は効くのに、npm run build すると効かない → v3 で content の指定漏れです。.jsx が含まれているか確認してください。開発サーバーは緩く動くことがあるので、本番ビルドで初めて出ます。
クラスの順番を変えたら、見た目が変わってしまった → CSSの詳細度が同じ場合、あとに書かれたほうが勝ちます。 ですが、HTMLの class に書く順番は、CSSの中での順番とは関係ありません。 つまり class="p-4 p-8" の勝敗は、書いた順では決まりません。 同じ種類のクラスを2つ書かないでください。
ホストのブラウザから繋がらない → sudo ufw allow 5173/tcp の忘れか、--host 0.0.0.0 の付け忘れです。③に戻ってください。
Failed to resolve import "./Card.jsx" → ファイル名の大文字・小文字が違います。 Linux は区別します(コンポーネントの回と同じ事故です)。
後片づけ
開けたポートを閉じます。
~/tw-demo/ は、この回だけの実験用です。残しても構いませんし、消しても構いません。
~/react-demo/ と ~/web/ は、この記事では一切触っていません。 そのまま残してください。
~/react-demo/に Tailwind を入れたくなったかもしれませんが、この記事ではやりません。 理由は⑧のとおりです。react-demoのCSSは50行ほどで、①の悩みが1つも発生していません。 困っていないものに道具を入れると、道具の良し悪しが分からなくなります。
まとめ
- 素のCSSで詰まるのは「書き方」ではない。 名前が思いつかない・どこに書いたか分からない・消していいか分からないの3つ
- CSSフレームワークは正反対の2種類。出来合いの部品を配る型(Bootstrap)と、1プロパティ分の道具を配る型(Tailwind)。既定のデザインが欲しいか、邪魔かで選ぶ
- Tailwind は「CSSを書かなくてよくする」道具ではない。 書く場所を、別ファイルからそのタグに移す道具。
p-4はpadding: 1remの別名 - Tailwind はソースをただのテキストとして読む。 JavaScript を実行しない。だから
bg-${color}-500は永遠に見つからず、エラーも出ずに背景が消える - 完全なクラス名がソースにあれば、配列の中でも動く。 判定基準は「JSとして動的か」ではなく「文字列がそのまま書いてあるか」
- 行数は大して変わらない。 変わるのは「変更を頼まれたときに、どこを開くか」。5つの変更のうち4つは Tailwind が有利で、「全部を一度に変えたい」だけが完敗する
- その完敗は、コンポーネントで消える。
@applyに逃げると、名前・置き場所・削除の悩みが全部戻ってきて、利点だけが消える - 「読みにくい」という批判は正しい。 Tailwind の主張は「読みにくくない」ではなく、「読みにくさと引き換えに、名前と削除の問題が消える」という取引
style属性とは違う。hover:とmd:が書けるのが決定的な差。インラインスタイルでは擬似クラスもメディアクエリも書けない- 出力が小さいのは、削っているからではなく、作っていないから。
bg-lime-300は使っていなければ1バイトも出ない - ただし、手書きCSSより小さくなるわけではない。 Preflight とテーマ変数で12KBほどの固定費があり、小規模では割に合わない
- 入れないという判断が正しい場面がある。 CSSが200行で足りている / ビルド工程が無い / コンポーネントの仕組みが無い、のどれかなら見送る
- フレームワークは、CSSを学ばなくていい理由にならない。
items-centerが効かないとき、直すのに要るのはalign-itemsの理解
参考リンク
- roadmap.sh — Frontend(CSS Frameworks / Tailwind の項目)
- Tailwind CSS — Vite へのインストール
- Tailwind CSS — ユーティリティクラスで見た目を作る
- Tailwind CSS — ソースからクラスを検出する仕組み
- Tailwind CSS — 関数とディレクティブ(
@applyを含む) - Tailwind CSS — Preflight
- prettier-plugin-tailwindcss — クラスの並び順を自動で揃える
- CSS Utility Classes and "Separation of Concerns"(Tailwind 作者による、批判への回答)
- Bootstrap 公式
- MDN — CSS の詳細度
次に読む
この記事は 【第4段階】フロントエンド の 10 / 15 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- CSSフレームワーク(出来合いの部品型と、細かい道具型)
- Tailwind CSS — クラス名を考えるのをやめる
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント