HTML と CSS を覚えたあと、React を触り始めると、最初の30分で必ずこの壁に当たります。
これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で部品を作り始めた人が、「見た目をどこに書けばいいのか、いつまでも決まらない」ところで止まったときに読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて 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 との相性も良くないこと
- 一番つらいのは「どれを選んだか」ではなく「混ざっていること」であること
この記事でやること
~/reactlabに練習用の React プロジェクトを作る(ポートは 5184)- 同じボタンを、素のCSS / CSS Modules / インラインスタイル / Tailwind の4通りで書く
- クラス名の衝突を、わざと起こす。CSS Modules が名前を変えているのを開発者ツールで確認する
style={{}}を渡した子が再描画されるのを、再描画の回と同じやり方で数える- 動的な値を、クラス切り替えとCSS変数の2通りで当てて比べる
- 判断表を作って1つに決め、練習場を片づける
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| グローバル | どこに書いても、ページ全体に効く状態のこと。CSS はもともと全部これ |
| スコープ | 効く範囲のこと。「このコンポーネントの中だけ」に限定することを「スコープを切る」と言う |
| CSS Modules | ファイル名を 〜.module.css にすると、ビルド時にクラス名を一意な名前に付け替えてくれる仕組み |
| インラインスタイル | HTML の style 属性に直接書くやり方。React では style={{ color: 'red' }} と書く |
| 擬似クラス | :hover や :focus のような、状態に応じて効くセレクタのこと |
| CSS変数(カスタムプロパティ) | --main: red; のように CSS の中で定義できる変数。var(--main) で使う |
| CSS-in-JS | JavaScript のファイルの中に CSS を書くやり方の総称。styled-components や Emotion がこれ |
| RSC(React Server Components) | サーバー側だけで動くコンポーネントの仕組み。ブラウザに JavaScript を送らない |
① 練習場を作る
壊しながら試すので、専用のプロジェクトを1つ作ります。
VMの中で実行します。
確認: ls src で App.jsx と main.jsx が出れば成功です。
App.css App.jsx assets index.css main.jsx
この記事では 5184 番ポートを使います。 本線や他の深掘りで使った 5173 とは別にして、同時に動いていても混ざらないようにします。
起動します。
--host 0.0.0.0 が要る理由は、これが無いと VM の中からしか繋がらないからです(ネットワークの回)。VM の IP は ip a で調べます。
ホストの Windows のブラウザで http://<VMのIP>:5184/ を開いて、Vite のロゴが出れば準備完了です。
この記事では、以降ずっと
npm run devを動かしたままにします。 保存するたびにブラウザが自動更新されます。止めるのはCtrl + C、再開は同じコマンドです。
最初に、既定のスタイルを消します。 Vite のテンプレートには最初から CSS が入っていて、これが残っていると「自分が書いた 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 を作ります。
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:
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か月後の自分は、当時どういう規約にしたかを覚えていないからです。
先に進む前に、壊した状態を戻します。
App.jsx から DangerButton の import と <DangerButton> の行も消してください。
確認: 青いボタンが青に戻れば、戻せています。
④ 方式② — CSS Modules
「名前を人間が管理するのをやめる」のが、CSS Modules です。
やることは1つだけです。ファイル名を 〜.module.css にします。 Vite は最初からこれに対応しているので、追加のインストールはありません。
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つとしてだけ扱います。
入れます。
vite.config.js を書き換えます。
src/index.css に1行だけ書きます。
開発サーバーを一度止めて(Ctrl + C)、起動し直します。 vite.config.js は保存すると自動で読み直されますが、念のためです。
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 で止めてから実行し、あとで起動し直します。
.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)で、falseundefinednull''を捨てる- 残ったものを半角スペースで繋ぐ
使います。
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
このプロジェクトで「ボタンの色を変えてください」と言われたとき、何が起きるか。
Button.module.cssを直す → 変わらないApp.cssを見に行く →.buttonがあった。直す → 一部だけ変わった- 開発者ツールで見る →
style属性が勝っていた 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/ とは別物です。消す前に、何を消すのかを目で見ます。
開発サーバーを止めます。 動かしている端末で Ctrl + C を押します。止まったことを確認します。
確認: 何も返らなければ、止まっています。
ポートを閉じます。
確認: 一覧に 5184/tcp が残っていなければ成功です。
プロジェクトを消します。
確認: 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か月後の自分は他人なので、書いていなければまた別の方式を足す
参考リンク
- roadmap.sh — React
- roadmap.sh — Frontend
- React 公式 — Adding Styles
- React 公式 — DOM Components(style 属性の扱い)
- React 公式 — memo
- Vite 公式 — CSS(CSS Modules を含む)
- MDN — CSS カスタムプロパティ(CSS変数)
- MDN — style 属性
- MDN — :hover
- Tailwind CSS 公式
- styled-components 公式
- Emotion 公式
次に読む
この記事は 【深掘り】React の 15 / 24 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | エラー境界 — 例外1つで画面が真っ白 |
| → 次の記事 | UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- 素のCSS / CSS Modules / インライン / Tailwind を比べる
- CSS変数で動的な値を渡す
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント