Reactのスタイリング — CSSの当て方を1つに決める

Reactのスタイリング。ブラウザのUIとCSSの書類、配色見本。

HTML と CSS を覚えたあと、React を触り始めると、最初の30分で必ずこの壁に当たります。

前回: エラー境界 — 例外1つで画面が真っ白

これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で部品を作り始めた人が、「見た目をどこに書けばいいのか、いつまでも決まらない」ところで止まったときに読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、すべて VM の中(Ubuntu Server)で打ちます。 画面の確認はホストの Windows のブラウザです。 npm が入っていることが前提です(npmの回)。 新しく ~/reactlab を作ります。 本線で使った ~/react-demo/ は触りません。

このボタンの色は、どこに書けばいいのか。

CSSの基本の回では、答えは1つでした。style.css に書いて、HTML から読み込む。以上です。

ところが React には、それに当たる「標準の答え」がありません。

公式ドキュメントを読んでも、「CSSはこう当ててください」とは書いてありません。書いていないのではなく、決めていないのです。React は画面の組み立て方を担当するライブラリで、見た目の当て方は利用者に任されています。

その結果、検索するとこうなります。

  • 「React CSS」で調べる → 素の CSS ファイルを import する記事が出てくる
  • もう少し調べる → CSS Modules が出てくる。「グローバル汚染を防げます」と書いてある
  • 別の記事 → styled-components。「CSS-in-JS が主流です」と書いてある
  • また別の記事 → Tailwind。「もうクラス名を考えなくていい」と書いてある
  • さらに → style={{}} で十分、という記事も出てくる

全部それらしく見えます。 そして、どれも「間違い」ではありません。だから決まりません。

決まらないまま何が起きるかというと、全部を少しずつ使ったプロジェクトができあがります。自分がそうでした。

src/
├── App.css              ← 最初に作ったやつ
├── Button.module.css    ← 途中で「衝突するらしい」と知って足した
├── components/
│   └── Card.jsx         ← style={{ padding: 16 }} が直書きしてある
└── index.css            ← Tailwind の @import も書いてある

このプロジェクトで「ボタンの余白を4px広げてください」と言われたとき、どこを開けばいいか、もう分かりません。 4箇所を全部見て、どれが勝っているかを開発者ツールで調べることになります。デザインシステムの回で「同じボタンが3種類できる」と書きましたが、あれの、もっと手前の話です。

この記事は「どれが正解か」を言いません。言えないからです。 代わりに、同じボタンを4通りで実際に書いて、何が違うのかを目で見ます。 そのうえで、自分のプロジェクトで1つに決めるための基準を作ります。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • React には「CSSの当て方」の標準が無いこと。決まっていないのが仕様であって、探せばどこかに正解が書いてあるわけではないこと
  • 素のCSSファイルは、import してもグローバルであること。コンポーネントの中に書いても、ページ全体に効く
  • CSS Modules がやっているのは、クラス名の付け替えだけであること。魔法ではなく、ビルド時に名前を一意にしているだけ
  • インラインスタイル(style={{}})では :hover もメディアクエリも書けないこと。書けないのは制限ではなく、DOM の style 属性がそういうものだから
  • style={{}} は毎回新しいオブジェクトを作るので、React.memo を貼った子を素通りして再描画させること
  • 動的な値の当て方は2つに絞れること。クラスを切り替えるか、CSS変数に流し込むか。後者のほうがきれい
  • クラス名を文字列で組み立ててはいけないこと。Tailwind ではエラーも出さずに消える
  • CSS-in-JS(styled-components / Emotion)には実行時のコストがあること。React Server Components との相性も良くないこと
  • 一番つらいのは「どれを選んだか」ではなく「混ざっていること」であること

この記事でやること

  1. ~/reactlab に練習用の React プロジェクトを作る(ポートは 5184)
  2. 同じボタンを、素のCSS / CSS Modules / インラインスタイル / Tailwind の4通りで書く
  3. クラス名の衝突を、わざと起こす。CSS Modules が名前を変えているのを開発者ツールで確認する
  4. style={{}} を渡した子が再描画されるのを、再描画の回と同じやり方で数える
  5. 動的な値を、クラス切り替えとCSS変数の2通りで当てて比べる
  6. 判断表を作って1つに決め、練習場を片づける

先に知る言葉

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

言葉意味
グローバルどこに書いても、ページ全体に効く状態のこと。CSS はもともと全部これ
スコープ効く範囲のこと。「このコンポーネントの中だけ」に限定することを「スコープを切る」と言う
CSS Modulesファイル名を 〜.module.css にすると、ビルド時にクラス名を一意な名前に付け替えてくれる仕組み
インラインスタイルHTML の style 属性に直接書くやり方。React では style={{ color: 'red' }} と書く
擬似クラス:hover や :focus のような、状態に応じて効くセレクタのこと
CSS変数(カスタムプロパティ)--main: red; のように CSS の中で定義できる変数。var(--main) で使う
CSS-in-JSJavaScript のファイルの中に CSS を書くやり方の総称。styled-components や Emotion がこれ
RSC(React Server Components)サーバー側だけで動くコンポーネントの仕組み。ブラウザに JavaScript を送らない

① 練習場を作る

壊しながら試すので、専用のプロジェクトを1つ作ります。

VMの中で実行します。

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

確認: ls src で App.jsx と main.jsx が出れば成功です。

bash
$ ls src
App.css  App.jsx  assets  index.css  main.jsx

この記事では 5184 番ポートを使います。 本線や他の深掘りで使った 5173 とは別にして、同時に動いていても混ざらないようにします。

bash
$ sudo ufw allow 5184/tcp
$ sudo ufw status

起動します。

bash
$ npm run dev -- --host 0.0.0.0 --port 5184

--host 0.0.0.0 が要る理由は、これが無いと VM の中からしか繋がらないからです(ネットワークの回)。VM の IP は ip a で調べます。

ホストの Windows のブラウザで http://<VMのIP>:5184/ を開いて、Vite のロゴが出れば準備完了です。

この記事では、以降ずっと npm run dev を動かしたままにします。 保存するたびにブラウザが自動更新されます。止めるのは Ctrl + C、再開は同じコマンドです。

最初に、既定のスタイルを消します。 Vite のテンプレートには最初から CSS が入っていて、これが残っていると「自分が書いた CSS が効いていない」と勘違いします。

bash
$ : > src/App.css
$ : > src/index.css

: > ファイル名 は「中身を空にする」という意味です。ファイルは残ります。rm してしまうと import が失敗するので、消さずに空にします。

確認: ブラウザの画面がずれて、飾りの無い素の表示になれば成功です。

② 比べるものを決める — 同じボタンを4回作る

4つの方式を並べて比べるには、作るものを固定しないと意味がありません。 この記事では、この1つのボタンを4回作ります。

  • 背景は青、文字は白
  • 角を丸める
  • :hover で少し暗くする
  • 画面が狭いとき(480px以下)は、横幅いっぱいに広がる
  • disabled のときは灰色になる

:hover と メディアクエリを入れているのは、わざとです。 ここが、方式によって書ける/書けないが分かれる場所だからです。

src/App.jsx を、いったんこうします。

export default function App() {
  return (
    <div style={{ padding: 24, fontFamily: 'sans-serif' }}>
      <h1>CSSの当て方を比べる</h1>
    </div>
  )
}

ここで style={{}} を使っているのは、比較対象を汚さないためです。この外枠は、どの方式にも属さない足場だと思ってください。

③ 方式① — 素のCSSファイル

一番素直なやり方です。 CSS ファイルを作って、コンポーネントから import します。

src/PlainButton.css を作ります。

bash
$ cat > src/PlainButton.css <<'EOF'
  .button {
    background: #2563eb;
    color: #fff;
    border: none;
    border-radius: 6px;
    padding: 8px 16px;
    font-size: 14px;
    cursor: pointer;
  }
  .button:hover {
    background: #1d4ed8;
  }
  .button:disabled {
    background: #9ca3af;
    cursor: not-allowed;
  }
  @media (max-width: 480px) {
    .button { width: 100%; }
  }
  EOF

src/PlainButton.jsx を作ります。

import './PlainButton.css'

export default function PlainButton({ children, ...rest }) {
  return (
    <button className="button" {...rest}>
      {children}
    </button>
  )
}

App.jsx から呼びます。

import PlainButton from './PlainButton'

export default function App() {
  return (
    <div style={{ padding: 24, fontFamily: 'sans-serif' }}>
      <h1>CSSの当て方を比べる</h1>
      <PlainButton>素のCSS</PlainButton>
      <PlainButton disabled>無効</PlainButton>
    </div>
  )
}

確認: 青いボタンと灰色のボタンが出て、青いほうにカーソルを乗せると暗くなれば成功です。ブラウザの幅を480px以下に狭めると、横いっぱいに広がります(レスポンシブの回でやったメディアクエリです)。

ここまでは、何も問題ありません。 :hover もメディアクエリも disabled も、素の CSS なので全部書けます。

import してもグローバルであることを、目の前で壊す

多くの人が、ここを誤解しています。 自分もそうでした。

「PlainButton.jsx の中で import したんだから、このCSSは PlainButton の中だけに効くはずだ」

効きません。 import './PlainButton.css' がやっているのは、「このCSSをページに読み込む」だけです。どのコンポーネントから読み込んだかは、CSS には一切伝わりません。

証拠を作ります。別のコンポーネントで、同じ .button という名前を使います。

src/DangerButton.css:

bash
$ cat > src/DangerButton.css <<'EOF'
  .button {
    background: #dc2626;
    border-radius: 999px;
    padding: 4px 10px;
  }
  EOF

src/DangerButton.jsx:

import './DangerButton.css'

export default function DangerButton({ children }) {
  return <button className="button">{children}</button>
}

App.jsx に足します。

import PlainButton from './PlainButton'
import DangerButton from './DangerButton'

export default function App() {
  return (
    <div style={{ padding: 24, fontFamily: 'sans-serif' }}>
      <h1>CSSの当て方を比べる</h1>
      <PlainButton>素のCSS</PlainButton>
      <PlainButton disabled>無効</PlainButton>
      <DangerButton>危険</DangerButton>
    </div>
  )
}

確認してください。 期待は「青いボタンと、赤い丸いボタン」です。

[スクリーンショット: 01_クラス名が衝突する.png] .button を2つのファイルで定義した結果、青いはずのボタンまで赤く(または角が変わって)なっている画面を撮ってください。

実際には、青いボタンまで巻き添えを食います。 後から読み込まれたほうが勝つので、DangerButton.css の .button が、PlainButton にも効きます。

開発者ツールで確かめます(F12の回)。青いボタンを右クリック →「検証」で、Styles の欄に .button が2つ並び、片方に取り消し線が入っているのが見えます。

これが「グローバル」ということです。 ファイルを分けても、コンポーネントを分けても、CSS のクラス名は世界に1つの名前空間を共有しています。

だから、素のCSSでやるなら「名前を絶対にぶつけない規約」が要ります。 .plain-button、.danger-button のように接頭辞を付けるか、BEM のような命名規則を人間が守り続けるか、です。

そして、それは守られません。 一人でも守れませんでした。3か月後の自分は、当時どういう規約にしたかを覚えていないからです。

先に進む前に、壊した状態を戻します。

bash
$ rm src/DangerButton.css src/DangerButton.jsx

App.jsx から DangerButton の import と <DangerButton> の行も消してください。

確認: 青いボタンが青に戻れば、戻せています。

④ 方式② — CSS Modules

「名前を人間が管理するのをやめる」のが、CSS Modules です。

やることは1つだけです。ファイル名を 〜.module.css にします。 Vite は最初からこれに対応しているので、追加のインストールはありません。

bash
$ cat > src/ModButton.module.css <<'EOF'
  .button {
    background: #16a34a;
    color: #fff;
    border: none;
    border-radius: 6px;
    padding: 8px 16px;
    font-size: 14px;
    cursor: pointer;
  }
  .button:hover {
    background: #15803d;
  }
  .button:disabled {
    background: #9ca3af;
    cursor: not-allowed;
  }
  @media (max-width: 480px) {
    .button { width: 100%; }
  }
  EOF

src/ModButton.jsx:

import styles from './ModButton.module.css'

export default function ModButton({ children, ...rest }) {
  return (
    <button className={styles.button} {...rest}>
      {children}
    </button>
  )
}

違いは2箇所だけです。

  • import styles from ... と、名前を付けて受け取る(素のCSSは名前を付けなかった)
  • className="button" ではなく className={styles.button}

App.jsx に足して、画面に出します。

import PlainButton from './PlainButton'
import ModButton from './ModButton'

export default function App() {
  return (
    <div style={{ padding: 24, fontFamily: 'sans-serif' }}>
      <h1>CSSの当て方を比べる</h1>
      <PlainButton>素のCSS</PlainButton>
      <ModButton>CSS Modules</ModButton>
    </div>
  )
}

クラス名が、勝手に変わっているのを見る

ここが CSS Modules の全部です。 開発者ツールで、緑のボタンを検証してください。

[スクリーンショット: 02_CSSModulesのクラス名.png] 開発者ツールの Elements で、緑のボタンの class 属性に button ではない長い名前が入っているところを撮ってください。

class="button" にはなっていません。_button_1a2b3_1 のような、見覚えのない名前が入っています。

Console でも確かめられます。 ModButton.jsx に一時的にこう足します。

console.log(styles)

Console に、こういうオブジェクトが出ます。

{ button: "_button_1a2b3_1" }

これが CSS Modules の正体です。 ビルド時に、.button という名前を「このファイル専用の一意な名前」に付け替え、その対応表を JavaScript のオブジェクトとして渡してくれているだけです。

魔法ではありません。 スコープを作る新しい機能がブラウザに増えたわけでもありません。名前をぶつからないように変えているだけです。

だから、③でやった衝突は、原理的に起きません。 別のファイルで .button と書いても、別の一意な名前になるからです。

そして重要なのは、CSSの機能は1つも減っていないことです。:hover もメディアクエリも :disabled も、素のCSSとまったく同じように書けます。 書いているのは、ただのCSSファイルだからです。

確認が済んだら、console.log(styles) の行は消しておいてください。

⑤ 方式③ — インラインスタイル

style 属性に直接書くやり方です。 React では、文字列ではなくオブジェクトを渡します。

src/InlineButton.jsx:

export default function InlineButton({ children, ...rest }) {
  return (
    <button
      style={{
        background: '#7c3aed',
        color: '#fff',
        border: 'none',
        borderRadius: 6,
        padding: '8px 16px',
        fontSize: 14,
        cursor: 'pointer',
      }}
      {...rest}
    >
      {children}
    </button>
  )
}

書き方の注意が3つあります。

  • {{ }} の外側は JSX の中括弧、内側はオブジェクトです(JSXの回でやった「JSXの中括弧はJavaScriptを書く場所」です)
  • プロパティ名がキャメルケースになります。background-color → backgroundColor、font-size → fontSize
  • 数字だけ書くと px が付きます。 padding: 8 は 8px。ただし lineHeight など、単位を持たない一部は付きません

App.jsx に足して表示します。

確認: 紫のボタンが出れば成功です。

:hover もメディアクエリも書けない

やってみてください。書けません。

style={{ ':hover': { background: '#000' } }}

何も起きません。 エラーも出ません。無視されます。

style={{ '@media (max-width: 480px)': { width: '100%' } }}

これも無視されます。

なぜ書けないのかを、ちゃんと押さえてください。「React の手抜き」ではありません。

style={{}} は、最終的に HTML の style 属性になります。 style 属性が書けるのは「この要素1つに、いま、この値を当てる」だけです。 :hover は「状態によって変わる」、メディアクエリは「画面幅によって変わる」。どちらも「条件」であって、1つの値ではありません。

条件を書けるのは、セレクタを持つCSSだけです。style 属性にはセレクタがありません。構造上、書けないのです。

JavaScript で代用しようとすると、こうなります。

const [hover, setHover] = useState(false)

<button
  onMouseEnter={() => setHover(true)}
  onMouseLeave={() => setHover(false)}
  style={{ background: hover ? '#5b21b6' : '#7c3aed' }}
>

動きます。動きますが、これは負けです。

  • マウスの出入りのたびに state が変わり、再描画が走ります。 CSS の :hover は再描画しません
  • キーボード操作では動きません。 :focus-visible に相当するものを、また別に書くことになります(アクセシビリティの回)
  • タッチ端末では onMouseLeave が来ないことがあります

ブラウザが無料でやってくれることを、自分の JavaScript で再実装しているわけです。やってはいけない方向です。

⑥ 方式④ — Tailwind

4つめは Tailwind です。 本線のTailwindの回で、入れ方と「なぜクラス名を考えなくてよくなるのか」は済ませています。この記事では、比較対象の1つとしてだけ扱います。

入れます。

bash
$ npm install tailwindcss @tailwindcss/vite

vite.config.js を書き換えます。

bash
$ cat > vite.config.js <<'EOF'
  import { defineConfig } from 'vite'
  import react from '@vitejs/plugin-react'
  import tailwindcss from '@tailwindcss/vite'
  
  export default defineConfig({
    plugins: [react(), tailwindcss()],
  })
  EOF

src/index.css に1行だけ書きます。

bash
$ echo '@import "tailwindcss";' > src/index.css

開発サーバーを一度止めて(Ctrl + C)、起動し直します。 vite.config.js は保存すると自動で読み直されますが、念のためです。

bash
$ npm run dev -- --host 0.0.0.0 --port 5184

src/TwButton.jsx:

export default function TwButton({ children, ...rest }) {
  return (
    <button
      className="w-full rounded-md bg-orange-600 px-4 py-2 text-sm text-white hover:bg-orange-700 disabled:cursor-not-allowed disabled:bg-gray-400 sm:w-auto"
      {...rest}
    >
      {children}
    </button>
  )
}

確認: オレンジのボタンが出て、:hover で暗くなれば成功です。

注目してほしいのは、hover: と disabled: と sm: の3つです。

  • hover:bg-orange-700 → 擬似クラスが書けます。⑤で書けなかったものです
  • disabled:bg-gray-400 → 状態も書けます
  • w-full sm:w-auto → メディアクエリが書けます(狭いとき全幅、sm 以上で自動幅)

なぜ書けるのかというと、Tailwind は最終的に本物のCSSファイルを作っているからです。style 属性ではありません。 クラス名を書いているだけで、中身は③④と同じ「セレクタを持つCSS」です。

ここが、4つを分ける一番大きな線です。 ①②④は「CSSを書いている」。③だけが「CSSではないもの」を書いています。

⑦ 4つを、表で比べる

ビルドしてサイズも見ます。 開発サーバーを止めずに、別の端末(もう1つ SSH で繋いだ窓)で実行してください。1つしか窓が無ければ、Ctrl + C で止めてから実行し、あとで起動し直します。

bash
$ npm run build
$ ls -l dist/assets/

.css ファイルのバイト数が出ます。具体的な数字は、書いた量とバージョンで変わります。 大事なのは傾向です。

① 素のCSS② CSS Modules③ インライン④ Tailwind
名前の衝突起きる(人間が規約で防ぐ)起きない(自動で改名)起きない(そもそも名前が無い)起きない(意味が固定)
:hover / メディアクエリ書ける書ける書けない書ける
動的な値苦手(クラス切替かCSS変数)苦手(同上)得意(JSの値をそのまま)苦手(組み立て禁止)
ビルド後のCSSサイズ書いた分だけ増え続ける同じ(消し忘れも残る)0(JSに混ざる)使った分だけ(未使用は出ない)
学習コストほぼ無い(CSSそのもの)小さい(styles.x を覚えるだけ)小さい(が、罠が多い)大きい(クラス名を覚える)
移植性(他所へ持っていけるか)高い(ただのCSS)高い(ただのCSS)高い(依存が無い)低い(Tailwind が要る)
消していいか分かるか分からない分かりやすい(ファイルが対応)分かる(コンポーネントと一体)分かる(消せば消える)

「ビルド後のCSSサイズが 0」を、③の長所だと読まないでください。 CSSが消えたのではなく、JavaScript のほうに移っただけです。JSのバイト数は増えます。 そして、次の節でやるとおり、実行時のコストも増えます。

⑧ style={{}} は、再描画を増やす

ここが、この記事で一番効く節です。

再描画の回で、React.memo を貼っても、props にオブジェクトを渡すと素通りすることをやりました。style={{}} は、まさにそのオブジェクトです。

数えます。 道具は console.log です。

src/CountDemo.jsx を作ります。

import { memo, useState } from 'react'

let plainCalls = 0
let inlineCalls = 0

const PlainChild = memo(function PlainChild({ className }) {
  plainCalls += 1
  console.log('クラス名で受けた子:', plainCalls)
  return <button className={className}>クラス</button>
})

const InlineChild = memo(function InlineChild({ style }) {
  inlineCalls += 1
  console.log('styleオブジェクトで受けた子:', inlineCalls)
  return <button style={style}>インライン</button>
})

export default function CountDemo() {
  const [n, setN] = useState(0)
  return (
    <div>
      <p>親を {n} 回再描画しました</p>
      <button onClick={() => setN(n + 1)}>親を再描画する</button>
      <PlainChild className="button" />
      <InlineChild style={{ background: '#7c3aed', color: '#fff' }} />
    </div>
  )
}

App.jsx から呼びます。

import CountDemo from './CountDemo'

Console を開いて、「親を再描画する」を5回押してください。

[スクリーンショット: 03_styleオブジェクトで数える.png] Console に「クラス名で受けた子」が増えず、「styleオブジェクトで受けた子」だけが増えている状態を撮ってください。

こうなります(StrictMode が有効なので、開発中は描画のたびに2回ずつ呼ばれ、数字も2ずつ増えます)。

クラス名で受けた子: 1
クラス名で受けた子: 2
styleオブジェクトで受けた子: 1
styleオブジェクトで受けた子: 2
styleオブジェクトで受けた子: 3
styleオブジェクトで受けた子: 4
styleオブジェクトで受けた子: 5
styleオブジェクトで受けた子: 6
styleオブジェクトで受けた子: 7
styleオブジェクトで受けた子: 8
styleオブジェクトで受けた子: 9
styleオブジェクトで受けた子: 10
styleオブジェクトで受けた子: 11
styleオブジェクトで受けた子: 12

className を渡した子は、押しても増えません。 渡しているのが "button" という文字列なので、Object.is("button", "button") が true になり、memo が止めます。 style={{}} を渡した子は、押すたびに増えます。 { background: ... } は、親が再描画されるたびに、その場で作られる新しいオブジェクトです。中身は同じでも、Object.is は false を返します。

Console で確かめられます。

> Object.is('button', 'button')
true
> Object.is({ a: 1 }, { a: 1 })
false

「じゃあ useMemo で包めばいい」と思うところですが、待ってください。

const style = useMemo(() => ({ background: '#7c3aed' }), [])

動きます。動きますが、useMemoの回で書いたとおり、これは「対処」であって「解決」ではありません。 ボタン1つごとに useMemo を書き足していくのは、維持できません。

解決は、そもそもオブジェクトを props で渡さないことです。クラス名(文字列)で渡せば、この問題は最初から発生しません。

これが、style={{}} を「基本の当て方」にしてはいけない、いちばん実務的な理由です。

⑨ 動的な値を、どう当てるか

ここまで読むと、当然こう思います。

「クラス名がいいのは分かった。でも、値が実行時に決まるときはどうするのか」

具体例で考えます。 進捗バーの幅を、0〜100 の数字で決めたい。この数字は、実行するまで分かりません。

手① — クラスを切り替える(clsx 相当を3行で自作する)

「決まった見た目の中から選ぶ」タイプなら、これで足ります。

条件によってクラスを付けたり外したりする関数は、clsx や classnames というライブラリで有名ですが、中身は3行です。 入れる前に、自分で書いてみます。

src/cx.js:

export function cx(...classes) {
  return classes.filter(Boolean).join(' ')
}

やっていることは2つだけです。

  • filter(Boolean) で、false undefined null '' を捨てる
  • 残ったものを半角スペースで繋ぐ

使います。

import { cx } from './cx'

function Button({ variant, disabled, children }) {
  return (
    <button
      className={cx(
        'button',
        variant === 'danger' && 'button--danger',
        disabled && 'button--disabled',
      )}
    >
      {children}
    </button>
  )
}

variant が danger のときだけ button--danger が付き、そうでなければ false になって捨てられます。結果は "button button--danger" という、ただの文字列です。⑧で見たとおり、文字列なら memo が効きます。

ライブラリを入れる前に、3行で書けるものかどうかを見てください。 入れてよいのですが、中で何をしているか分からないまま入れると、動かないときに詰みます。

手② — CSS変数に流し込む(これが一番きれい)

「値そのものが連続的に変わる」ものは、クラスでは表現できません。 幅が 37% のときのクラスを作るわけにはいきません。

ここで CSS変数を使います。

.bar {
  width: 200px;
  height: 12px;
  background: #e5e7eb;
  border-radius: 999px;
  overflow: hidden;
}
.bar__fill {
  width: var(--w, 0%);
  height: 100%;
  background: #2563eb;
  transition: width 0.2s;
}
function Bar({ percent }) {
  return (
    <div className="bar">
      <div className="bar__fill" style={{ '--w': `${percent}%` }} />
    </div>
  )
}

style={{}} を使っているじゃないか、と思うところですが、ここが肝心です。

見た目のルールは、全部CSSファイル側にあります。 JavaScript から渡しているのは「変数の値ひとつ」だけです。

この形なら、③の弱点をほぼ全部回避できます。

  • :hover もメディアクエリも、CSS側に普通に書けます
  • 色や角丸や transition を変えたいとき、開くのはCSSファイル1つです
  • JavaScript が知っているのは「37」という数字だけで、色コードも余白も知りません

var(--w, 0%) の 0% は「変数が無いときの既定値」です。書いておくと、--w を渡し忘れたときに幅が壊れずに 0 になります。

デザインシステムの回で作ったデザイントークンも、正体は同じ CSS変数です。トークンを「上から降らせる」のも、値を「JSから注入する」のも、同じ仕組みの表と裏です。

迷ったらこれです。 見た目はCSSに置き、変わる数値だけをCSS変数で渡す。

手③(やってはいけない) — クラス名を文字列で組み立てる

これは、書きたくなりますが、壊れます。

<button className={`bg-${color}-600`}>

本線のTailwindの回で実際に壊しました。Tailwind はソースを「ただのテキスト」として読んで、見つけたクラス名のCSSだけを作ります。 bg-blue-600 という文字列はソースのどこにも存在しないので、そのCSSは生成されず、色が付きません。エラーも出ません。

素のCSSやCSS Modules でも、程度は違いますが同じ問題が起きます。

  • 素のCSS → grep でクラス名を探しても引っかからないので、消していいかの判断ができなくなります
  • CSS Modules → styles[`bg-${color}`] は、対応表に無ければ undefined になり、class 属性そのものが付きません(エラーも出ずに、見た目だけ消えます)

対策は1つです。完全なクラス名を、ソースにそのまま書きます。

const COLORS = {
  blue: 'bg-blue-600',
  red: 'bg-red-600',
}

<button className={COLORS[color]}>

JavaScript としては同じくらい「動的」ですが、ソースには完全な文字列が書いてあります。 これで全部通ります。

⑩ CSS-in-JS(styled-components / Emotion)について

5つめの選択肢として、必ず名前が出てくるので触れておきます。 この記事では入れませんし、このサイトでは使いません。 理由を書きます。

書き味はこうです。

const Button = styled.button`
  background: ${props => props.$danger ? '#dc2626' : '#2563eb'};
  color: #fff;
  &:hover { opacity: 0.9; }
`

とてもよく出来ています。 :hover も書けて、props で分岐もできて、スコープも自動で切られます。③の弱点が全部消えています。 2020年前後に主流になったのには理由があります。

それでも、いま新しく選ばない理由が2つあります。

1つめ。実行時のコストです。

このCSSは、ブラウザで JavaScript が動いて初めて作られます。 文字列を組み立て、<style> タグをページに差し込み、クラス名を割り当てる——この一連の処理が、レンダーのたびに走ります。 ①②④はビルド時に .css ファイルが出来上がっているので、ブラウザは受け取って適用するだけです。やっている仕事の量が違います。

2つめ。React Server Components との相性です。

SSRの回で、サーバー側でHTMLを組み立てる話をやりました。RSC は、それをさらに進めて、そのコンポーネントの JavaScript をブラウザに送らない仕組みです。

ところが CSS-in-JS は、ブラウザで JavaScript が動くことを前提にしています。 だから、RSC の中では、そのままでは使えません。 'use client' を付けてクライアント側に落とすことになり、JavaScript を減らすために RSC を使ったのに、CSS のために送り返すという妙なことになります。

「古いから駄目」ではありません。 前提が変わったので、噛み合わなくなった、が正確です。 既存のプロジェクトが styled-components なら、慌てて剥がす必要はまったくありません。 剥がすコストのほうが高くつきます。

⑪ どう決めるか — 判断表

「一番いいのはどれですか」に答えはありません。 条件によって答えが変わるので、条件のほうを表にします。

あなたの状況選ぶもの理由
一人で、画面が10枚くらいまでCSS Modules覚えることが styles.x だけ。書いているのは素のCSSなので、いつでも他所へ持っていける
チームで、人が増えるTailwind規約を人間が守る必要が無い。「余白いくつにする?」の議論が消える。学習コストは最初の1週間だけ
デザインシステムやトークンが既にあるCSS Modules + CSS変数トークンは既にCSS変数で持っているはず。Tailwind を被せると、正が2箇所になる
パフォーマンスを最優先する(RSC / SSG)CSS Modules か Tailwindどちらもビルド時にCSSが確定する。実行時に組み立てない
既存プロジェクトに後から入るそこで使われているものこれが最優先。 好みで新しい方式を持ち込むのが、一番の害
1画面の実験・使い捨て素のCSS 1ファイル衝突するほど大きくならない。構えるほうが損

インラインスタイル(style={{}})は、表に「基本の方式」としては入れていません。 ⑧と⑨のとおり、「CSS変数の値を渡す」「計算結果の座標を渡す」といった、限定された用途の道具として使います。

このサイトでの決めは、こうします。

CSS Modules を基本にする。動的な値は CSS変数で渡す。style={{}} はそのためだけに使う。

理由は「移植性」です。 書いているものがただのCSSなので、Tailwind に乗り換えたくなっても、Next.js に移っても、書いた知識がそのまま残ります。 CSSの基本の回でやったことが、そのまま使えるということです。

⑫ 決めたら、混ぜない

最後に、この記事で一番言いたいことを書きます。

4つのうちどれを選んでも、そこそこ上手くいきます。 実際、大きなプロダクトがそれぞれの方式で動いています。選択そのもので失敗することは、あまりありません。

失敗するのは、決めないまま進んだときです。

冒頭に出した、あの状態です。

src/
├── App.css              ← 素のCSS
├── Button.module.css    ← CSS Modules
├── components/
│   └── Card.jsx         ← style={{}} 直書き
└── index.css            ← Tailwind

このプロジェクトで「ボタンの色を変えてください」と言われたとき、何が起きるか。

  1. Button.module.css を直す → 変わらない
  2. App.css を見に行く → .button があった。直す → 一部だけ変わった
  3. 開発者ツールで見る → style 属性が勝っていた
  4. Card.jsx の style={{}} を直す → 今度は別の画面が壊れた

4箇所を探すのに、20分かかります。 そして次に色を変えるときも、また20分かかります。 覚えられないからです。

CSSの当て方が混ざったプロジェクトは、CSSが書けないのではなく、「どこを見ればいいか分からない」ので手が止まります。

だから、決めることそのものに価値があります。 決め方の質より、決まっていることのほうが効きます。

そして、決めたら書き残してください。 デザインシステムの回で ADR(設計判断の記録)を書いたのと同じ形で、「CSSはCSS Modulesで当てる。動的な値はCSS変数。style={{}} はそれ以外に使わない」の3行を、README.md か docs/ に置きます。

3か月後の自分は他人です。 書いていなければ、また悩んで、また別の方式を足します。

つまずいたところ

最初、import './Button.css' がスコープを切ってくれると本気で思っていました。

コンポーネントの中で import しているんだから、そのコンポーネントの中だけに効くはずだ、と読んでいました。書いた本人にとっては、そう読めます。 実際にはただページに読み込んでいるだけで、どこから import したかはCSSに一切伝わりません。 これに気付いたのは、別の画面で作った .card が、前に作った画面の見た目を壊したときでした。関係ないファイルを触っていないのに壊れるのが理解できず、Vite のバグを疑って半日使いました。

CSS Modules は、しばらく「よく分からない黒魔術」でした。 styles.button と書くと動くけれど、何が起きているのかは知らないまま使っていました。console.log(styles) を1回打つだけで終わる話でした。{ button: "_button_1a2b3_1" } が出た瞬間に、「ただの対応表だったのか」と分かりました。分からない道具は、中身を1回表示してみるだけで大半が解けます。

style={{ ':hover': ... }} を、動かないまま30分書き直しました。 綴りを疑い、クォートを疑い、React のバージョンを疑いました。エラーが1つも出ないので、「書き方が悪い」としか思えなかったからです。style 属性にセレクタが書けるはずがない、と気付いたのは、生成されたHTMLを開発者ツールで見たときです。style="background: ...;" としか出ていませんでした。JSXの世界からいったん出て、出来上がったHTMLを見ると、たいてい解けます。

memo を貼ったのに効かない件は、再描画の回でも書きましたが、style={{}} が犯人だと繋がったのはこの記事を書いたときです。 「オブジェクトを props に渡すと効かない」は知っていたのに、style={{}} が「オブジェクトを渡している」ことに気付いていませんでした。 知識はあったのに、目の前のコードと結び付いていなかったわけです。

Tailwind を入れたとき、vite.config.js を直したのに反映されず、書き方を疑いました。 結局 Ctrl + C して起動し直したら直りました。設定ファイルは保存すると Vite が自動で再起動するはずなので、ターミナルに vite.config.js changed, restarting server... が出ていたかを、まず見るべきでした。 原因を確かめずに、20分使いました。

CSS変数に流し込む形は、この記事を書くまで思い付いていませんでした。 「動的な値=style={{}} に全部書く」しか選択肢が無いと思っていたので、色も余白も角丸も、全部JavaScript側に書いていました。 style={{ '--w': ... }} という書き方が有効だと知ったとき、これまで書いた style={{}} の9割が要らなかったことが分かりました。

後片づけ

~/reactlab は練習用に作ったものなので、丸ごと消して構いません。 本線で使った ~/react-demo/ とは別物です。消す前に、何を消すのかを目で見ます。

bash
$ ls ~/reactlab
$ du -sh ~/reactlab

開発サーバーを止めます。 動かしている端末で Ctrl + C を押します。止まったことを確認します。

bash
$ ss -tlnp | grep 5184

確認: 何も返らなければ、止まっています。

ポートを閉じます。

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

確認: 一覧に 5184/tcp が残っていなければ成功です。

プロジェクトを消します。

bash
$ rm -rf ~/reactlab
$ ls ~

確認: reactlab が消えていれば片づけ完了です。

戻し方: もう一度試したくなったら、①の npm create vite@latest reactlab -- --template react からやり直すだけです。数分で戻せます(node_modulesは消してよい)。 cx.js の3行だけは、どこかに控えておくと便利です。 自分のプロジェクトでそのまま使えます。

まとめ

  • React に「CSSの当て方」の標準は無い。 決まっていないのが仕様。探しても、どこにも正解は書いていない
  • import './x.css' はスコープを切らない。 やっているのは「ページに読み込む」だけで、どこから読み込んだかはCSSに伝わらない。別ファイルで同じクラス名を書けば、普通に衝突する
  • CSS Modules の正体は、クラス名の付け替え。 console.log(styles) を打てば { button: "_button_1a2b3_1" } というただの対応表が出る。魔法ではない
  • CSS Modules で書いているのは、素のCSSそのもの。 :hover もメディアクエリも、機能は1つも減らない
  • style={{}} では :hover もメディアクエリも書けない。 エラーも出ずに無視される。style 属性にはセレクタが無いので、構造上、条件が書けない
  • :hover を JavaScript で代用しない。 再描画が増え、キーボード操作で動かず、タッチ端末で崩れる。ブラウザが無料でやることを再実装している
  • style={{}} は毎回新しいオブジェクトを作るので、React.memo を素通りする。 Object.is({a:1},{a:1}) は false。文字列の className なら止まる
  • useMemo で包むのは対処であって解決ではない。 解決はオブジェクトを props で渡さないこと
  • ①②④は「CSSを書いている」、③だけが「CSSではないもの」を書いている。 これが4つを分ける一番大きな線
  • 動的な値の当て方は2つ。 決まった見た目から選ぶ → クラスを切り替える(cx は3行で自作できる)。連続的な値 → CSS変数に流し込む
  • CSS変数に流す形が一番きれい。 見た目のルールはCSSに残り、JavaScript が知るのは数字ひとつだけになる
  • クラス名を文字列で組み立てない。 Tailwind ではエラーも出さずに消える。完全な文字列をソースに書き、オブジェクトから引く
  • CSS-in-JS は、実行時にCSSを組み立てる。 RSC とは前提が噛み合わない。ただし既存プロジェクトを慌てて剥がす必要は無い
  • 選び方は状況で決まる。 一人なら CSS Modules、チームなら Tailwind、既存プロジェクトなら「そこで使われているもの」が最優先
  • 一番つらいのは、どれを選んだかではなく、混ざっていること。 4箇所を探して20分かかり、次も同じ20分がかかる
  • 決めたら3行で書き残す。 3か月後の自分は他人なので、書いていなければまた別の方式を足す

参考リンク


次に読む

この記事は 【深掘り】React の 15 / 24 本目です。

記事
← 前の記事エラー境界 — 例外1つで画面が真っ白
→ 次の記事UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない

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

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

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

Frontend›React — Styling
  • 素のCSS / CSS Modules / インライン / Tailwind を比べる
  • CSS変数で動的な値を渡す

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

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

コメント

コメントする

目次