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のプリミティブスケールをつくれます。