クラス名を考えるのをやめる — Tailwind CSS

Tailwind CSS。Webページと色・余白を示す小さなカード、配置用の定規。

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 の利点を捨てて欠点だけ残す
  • 入れないほうがいい場面があること。このサイト自身が、入れていない

この記事でやること

  1. VMの中に ~/tw-demo/(Vite + React)を作り、Tailwind を入れる(バージョンで手順が全く違うので、まず公式を見る)
  2. 同じ見た目のカードを、素のCSSとTailwindの両方で書いて並べる。行数ではなく「どこを直せばいいか」を比べる
  3. npm run build して、dist/ のCSSのバイト数を実測する。クラスを増やして再ビルドし、増えた分だけ増えることを確かめる
  4. bg-${color}-500 をわざと書いて壊す。なぜ壊れるかを、生成されたCSSを grep して確認する
  5. 繰り返しをコンポーネントに切り出して消す(Reactの回の回収)

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
CSSフレームワークあらかじめ用意されたCSSを読み込んで使う仕組み。自分でCSSを書く量を減らすためのもの
ユーティリティクラス1つのことだけをするクラス。p-4 は「内側の余白を1rem」、flex は「display:flex」。それ以上のことはしない
ユーティリティファースト見た目のほとんどをユーティリティクラスの組み合わせで作るやり方。Tailwind がこれ
コンポーネントクラス.btn .card のように、部品ひとかたまり分の見た目を1つの名前に入れたクラス。Bootstrap がこれ
PreflightTailwind が最初に流し込むリセットCSS。ブラウザ既定の見た目(見出しの大きさ、リストの点など)をいったん全部消す
パージ / ツリーシェイキング(CSSの)使われていないCSSを出力から落とすこと。ビルドツールの回でJSについてやったものの、CSS版
@applyTailwind の機能で、ユーティリティクラスをまとめて自分のクラスに入れるもの。後半で「使わない」という話をします

① まず、素のCSSで詰まるところを再現する

言葉で説明するより、1回書いたほうが早いです。

VMの中で、素のHTMLを置いてある ~/web/ に、確認用のファイルを1枚作ります。Vite も React も要りません。

bash
$ cd ~/web
$ nano naming.html

中身はこれだけです。

<!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 のような命名規則)は、名前の付け方を統一するものです。「名前を考える」という作業そのものは消えません。 消えるのは「付け方がバラバラになる」という別の問題です。

このファイルは、もう使いません。 消しておいて構いません。

bash
$ rm ~/web/naming.html

② CSSフレームワークには2種類ある

「CSSフレームワーク」と一括りにされますが、中身は正反対の2派です。ここを混ぜて理解すると、両方が分からなくなります。

出来合いの部品型細かい道具型
代表Bootstrap / Bulma / FoundationTailwind 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 autoprefixertailwindcss @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.extendCSSの @theme

この記事は v4 の手順で書きます。

プロジェクトを作る

VMの中で作ります。ビルドツールの回と同じ手順です。

bash
$ cd ~
$ npm create vite@latest tw-demo -- --template react
$ cd tw-demo
$ npm install

-- が2つ並んでいるのは打ち間違いではありません。 「ここから先は npm ではなく create-vite への引数だ」という区切りです(npmの回)。

Tailwind を入れる

bash
$ npm install tailwindcss @tailwindcss/vite

2つ入ります。

パッケージ役割
tailwindcss本体。 クラス名からCSSを作る部分
@tailwindcss/viteVite に組み込むための繋ぎ。 ビルドの途中でソースを読ませる

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;

動かして確認する

bash
$ sudo ufw allow 5173/tcp
$ npm run dev -- --host 0.0.0.0

ホストの 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で並んでいるだけです。

素のCSSTailwind
max-width: 24remmax-w-sm
padding: 1remp-4
border-radius: 0.5remrounded-lg
background: #ffffffbg-white
font-size: 0.875remtext-sm
display: flexflex
justify-content: flex-endjustify-end
gap: 0.5remgap-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; と書くかの違いしかありません。

比べるべきは「変更を頼まれたときに、どこを開くか」です。

頼まれたこと素のCSSTailwind
このカードの余白を広げて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 で止めてから実行します。

bash
$ cd ~/tw-demo
$ npm run build
$ ls -l dist/assets/

この記事の実機では、こう出ました。

-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 後も測ります。 実際に通信で流れるのはこちらです。

bash
$ gzip -c dist/assets/*.css | wc -c
3418

約3.3KB です。

使っていないクラスは、本当に入っていないのか

grep で直接確かめます。 使っていない色を探します。

bash
$ grep -c "bg-lime-300" dist/assets/*.css
0

1つも入っていません。 bg-lime-300 は Tailwind に存在するクラスですが、ソースに書いていないので、生成されていません。

ついでに、使っているものが入っていることも確かめます。

bash
$ grep -c "bg-blue-600" dist/assets/*.css
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 /> を置いてから、ビルドし直します。

bash
$ npm run build
$ ls -l dist/assets/*.css
$ gzip -c dist/assets/*.css | wc -c

実機ではこうなりました。

-rw-rw-r-- 1 ubuntu ubuntu  14106 Sep 10 11:09 index-9d2a71ef.css
3801

12,784 → 14,106 バイト。 50個弱のクラスを足して、1.3KB 増えました。

bash
$ grep -c "bg-lime-300" dist/assets/*.css
1

さっき無かったものが、入りました。

ここで、③の理屈がもう一度効いています。 CLASSES は JavaScript の配列で、className には {c} という変数で渡しています。 それでも動きます。 "bg-lime-300" という完全な文字列が、ソースファイルの中にそのまま書いてあるからです。Tailwind はテキストを読んでいるだけなので、それが配列の中だろうと関係ありません。 ④で壊れた bg-${color}-600 との違いは、「JavaScriptとして動的かどうか」ではなく、「ソースに完全な文字列があるかどうか」だけです。

[スクリーンショット: 04_ビルドサイズの比較.png] ls -l の結果を2回並べて、CSSのバイト数が増えていることが分かる画面を撮ってください。

元に戻す

bash
$ rm src/Sandbox.jsx

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行を書くために、何を知っている必要があるか。

クラス知っている必要があること
flexFlexbox という仕組みがあること(CSSの回)
items-center交差軸という概念。align-items が縦方向とは限らないこと
justify-between主軸という概念。flex-direction を変えると意味が変わること
gap-4gap が 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 は区別します(コンポーネントの回と同じ事故です)。


後片づけ

開けたポートを閉じます。

bash
$ sudo ufw delete allow 5173/tcp
$ sudo ufw status

~/tw-demo/ は、この回だけの実験用です。残しても構いませんし、消しても構いません。

bash
$ rm -rf ~/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 の理解

参考リンク


次に読む

この記事は 【第4段階】フロントエンド の 10 / 15 本目です。

記事
← 前の記事全消し再描画から卒業する — Reactの到達作品
→ 次の記事Reactにできないことがある — Web Components

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›CSS Frameworks
  • CSSフレームワーク(出来合いの部品型と、細かい道具型)
  • Tailwind CSS — クラス名を考えるのをやめる

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次