CSS・Tailwindのカラートークン設計 — 色変数の命名と整理
· 3分で読めます
色の変数をロールごとに命名・整理する方法、CSSでライトモードとダークモードをつなぐ方法、同じトークンをTailwind v4のテーマで使う方法を紹介します。
スタイルシートのあちこちに直接書かれたHEX値は、色の変更をつらい作業にするいちばんの原因です。ブランドの刷新、ダークモードの追加、コントラストの問題の修正が、 何百行にもわたる検索と置換になってしまいます。カラートークン、つまりその色が何のための色なのかを表す名前つきの変数が、これを解決します。 このガイドでは、素のCSSでトークンを組み立てる方法と、同じトークンをTailwindで使う方法を紹介します。
2つの層:プリミティブとロール
しっかりした設計では、色そのものと色の使い方を分けます。
プリミティブトークンは素のパレットで、色相と段階で名前をつけます。コンポーネントのスタイルに直接出てくることはありません。
:root {
--blue-100: #E3E8FF;
--blue-500: #3D5AFE;
--blue-700: #2638C4;
--sand-50: #F7F5F0;
--ink-900: #1D2433;
}セマンティック(ロール)トークンはUIの中での役目を表し、プリミティブを参照するか、独自の値を持ちます。コンポーネントが使うのはこちらだけです。
:root {
--color-bg: var(--sand-50);
--color-surface: #EFECE4;
--color-border: #DAD6CC;
--color-text: var(--ink-900);
--color-muted: #5C6475;
--color-primary: var(--blue-500);
--color-on-primary: #FFFFFF;
--color-accent: #C2410C;
}.button {
background: var(--color-primary);
color: var(--color-on-primary);
}
.card {
background: var(--color-surface);
border: 1px solid var(--color-border);
color: var(--color-text);
}これでボタンは、自分が青であることを知らなくなります。ブランドが緑に変わっても、書き換えるのは1行だけ。コントラストのチェックで不合格になっても、 トークンをひとつ調整すれば、すべてのコンポーネントがそれに従います。
トークンには見た目ではなくロールで名前をつける
--light-grayや--brand-blueのような名前は、その色の今の見た目を表しています。値が変わった瞬間に名前が間違いになり、 ダークモードでは--light-grayに暗い色が入ってしまいます。ロールの名前なら正しいままです。
- 構造には
--color-bg、--color-surface、--color-border。 - コンテンツには
--color-textと--color-muted。 - 強調には
--color-primary、--color-accent。 - 塗りの色の上に置く文字には
--color-on-primary、--color-on-accent。 - 必要に応じて状態のロール:
--color-success、--color-warning、--color-danger。
リストは短く保ちましょう。ほとんどのプロダクトは10個ほどのロールトークンでまかなえます。コンポーネントごとにトークンを足していくと、元の問題に逆戻りします。
ダークモードは新しい値のセットになる
ロールトークンがあれば、ダークモードは2つ目のスタイルシートではありません。同じ名前に違う値を入れるだけです。次のパターンはシステム設定に従いつつ、data-theme属性を使ってトグルでどちらのテーマにも切り替えられるようにしています。
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--color-bg: #14161F;
--color-surface: #1C1F2B;
--color-border: #2C3040;
--color-text: #E6E8EF;
--color-muted: #9AA1B2;
--color-primary: #8C9EFF;
--color-on-primary: #14161F;
--color-accent: #FB923C;
}
}
:root[data-theme="dark"] {
/* 手動でダークを選んだ人のために、同じ値を入れる */
}ダークのプライマリが明るい青になり、そのラベルが暗い色になっている点に注目してください。ダークの値は反転で計算するのではなく、選んで決めるべきです。 理由はダークモードのガイドで説明しています。
モダンなブラウザはlight-dark()関数にも対応していて、両方の値を1行にまとめられます。この関数はcolor-schemeプロパティに従うので、 動かすにはその宣言が必要です。
:root {
color-scheme: light dark;
--color-bg: light-dark(#F7F5F0, #14161F);
--color-text: light-dark(#1D2433, #E6E8EF);
}控えめな色は導き出す
サーフェスとボーダーは、手で選ぶ代わりに背景とテキストから混ぜてつくれます。CSSではcolor-mix()でこれができ、OKLCHで混ぜると均等で自然な段階になります。
:root {
--color-surface: color-mix(in oklch, var(--color-bg) 94%, var(--color-text));
--color-border: color-mix(in oklch, var(--color-bg) 82%, var(--color-text));
}ほかのトークンを参照しているので、ダークモードでは自動で更新されます。ボーダーが入力欄などのコントロールを示すなら、3:1を満たすか確認しましょう。
Tailwind CSS v4でトークンを使う
Tailwind v4の設定はCSSで書きます。@themeで宣言した--color-*変数は、どれも一式のユーティリティ (bg-*、text-*、border-*など)になります。生成されるユーティリティは実行時に変数を読むので (bg-primaryはbackground-color: var(--color-primary)になる)、ダークモードでは変数を上書きするだけで済みます。
@import "tailwindcss";
/* ライトの値がユーティリティになる: bg-bg, text-text, bg-primary ... */
@theme {
--color-bg: #F7F5F0;
--color-surface: #EFECE4;
--color-text: #1D2433;
--color-muted: #5C6475;
--color-primary: #3D5AFE;
--color-on-primary: #FFFFFF;
--color-accent: #C2410C;
}
/* ダークの値で同じ変数を上書きする */
@media (prefers-color-scheme: dark) {
:root {
--color-bg: #14161F;
--color-text: #E6E8EF;
--color-primary: #8C9EFF;
--color-on-primary: #14161F;
/* ... */
}
}<button class="bg-primary text-on-primary">Save</button>
<p class="text-muted">Last edited 2 hours ago</p>すべての要素にdark:バリアントをつける必要はありません。トークンがすでに切り替わるので、bg-primaryはどちらのテーマでも正しい色になります。
Tailwind v3
v3では、同じ変数を設定ファイルで対応づけます。
// tailwind.config.js
module.exports = {
theme: {
extend: {
colors: {
bg: 'var(--color-bg)',
surface: 'var(--color-surface)',
text: 'var(--color-text)',
primary: 'var(--color-primary)',
accent: 'var(--color-accent)',
},
},
},
}値をOKLCHで書く
色を保存しておくにはHEXで十分ですが、編集するときはOKLCHのほうが考えやすくなります。3つのチャンネルは明度、彩度(クロマ)、色相で、 明度は目に見える明るさとよく対応しています。ブランドカラーの文字用に暗いバージョンをつくるなら、Lだけを下げて残りはそのままにします。oklch(55% 0.2 265)がoklch(42% 0.2 265)になる、という具合です。現在の主要なブラウザはすべてoklch()に対応しています。
手で書く手間を省く
Colorsetのすべてのパレットは、まさにこの構造でエクスポートできます。ライト・ダーク用のロールトークンをCSS変数、Tailwind v4のテーマ、 Tailwind v3の設定、SCSS、JSON、デザイントークンとして、HEX・RGB・HSL・OKLCHのいずれかで書き出せます。気に入った配色を選び、エクスポートを開いて貼り付けるだけです。 プリミティブの層を自分でつくりたいなら、濃淡スケール生成でどんな色からでも50–950のプリミティブスケールをつくれます。