Hex から OKLCH へ:Tailwind CSS v4 トークン移行ガイド
従来の Hex / HSL Tailwind v3 設定を CSS Color 4 の @theme oklch() スケールへアップグレードする手順を解説します。
読了目安 6分 · 更新日: 2026-11-22
概要比較
| 比較項目 | 従来 Hex / HSL (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| 記述方式 | tailwind.config.js の Hex 文字列 | CSS @theme --color-* : oklch(...) |
| 知覚均等性 | なし(黄は青より極端に明るい) | あり(L 軸が知覚明るさと一致) |
| P3 広色域 | 8 ビット sRGB に制限 | Display P3・Rec.2020 を標準サポート |
| 動的な濃淡調整 | プリプロセッサ計算が必要 | CSS ネイティブ oklch(from var(--c) ... ) |
なぜ Tailwind v4 は標準パレットを Hex から OKLCH に変更したのか
従来の Hex 表記では見た目上の明るさが読み取れず、同じ 500 番台でも青と黄で視認性コントラストが大きく異なりました。
OKLCH は知覚明度 (L) を第 1 軸に配置するため、色相を変えてもボタンやバッジの視覚的重みが均一に保たれます。
- 50–950 のコントラスト階段が全色相で統一され、50–400 に濃色文字、600–950 に白文字が安定適合。
- Sass や PostCSS プラグインに頼らない純粋な CSS 相対カラー記述。
tailwind.config.js の Hex を CSS @theme へマッピングする
既存の theme.extend.colors または :root CSS 変数を Colr の変換ツールへ貼り付けるだけで、D65 sRGB 経由の厳密な W3C oklch() 値を得られます。
高明度(50–100)では sRGB 色域内に収まるよう控えめな彩度に保つのがポイントです。
tailwind.config.js の Hex を CSS @theme へマッピングする
CSS@import "tailwindcss";
@theme {
--color-brand-50: oklch(97.2% 0.014 261.2);
--color-brand-500: oklch(54.6% 0.215 262.9);
--color-brand-700: oklch(42.4% 0.178 263.5);
--color-brand-950: oklch(23.1% 0.086 264.1);
}移行後に WCAG 2.2 と APCA コントラストを再検証する
本番適用前に 50–950 スケール全体をコントラスト表で確認し、とくに 500–600 ボタン上の白文字を確認します。
OKLCH スケール生成器では WCAG AA と APCA Lc 境界を即座に確認できます。
- 500・600 番台で通常文字 4.5:1 を満たすかチェック。
- 広色域アクセントの sRGB フォールバック表示も確認。
このガイドで使用するツール
関連フォーマット
よくある質問
CSS oklch() を使うと古いブラウザで表示が崩れませんか?
2023 年以降の Chrome・Safari・Firefox・Edge はすべてネイティブ対応しています。旧環境向けには Hex 変数併用も可能です。
標準 sRGB モニターでは元の Hex と同じ色に見えますか?
はい、sRGB からの等価変換であれば Display P3 へ彩度を広げない限り完全に同じ見え方になります。
その他のガイド
- OKLCH vs HSL vs sRGB:広色域 Display P3 の正しい扱い方HSL・sRGB Hex・Display P3・OKLCH を知覚明るさ・グラデーション濁り・色域体積・プログレッシブ CSS の観点から比較します。
- W3C Design Tokens (DTCG 2025.10):Figma から CSS への標準パイプラインW3C DTCG 2025.10 JSON($type・$value colorSpace & components)で Figma と CSS / Tailwind v4 を劣化なく連携する手法を解説。
- WCAG 2.2 コントラスト比 vs APCA (Lc):アクセシビリティ実践ガイドWCAG 2.2 の相対輝度比(4.5:1)と最新 APCA 知覚コントラスト(Lc 60/75/90)を比較し、ダークモードや色覚検証の要点まで解説します。
- 同じ色を RGB・HSL・HSV・HWB・OKLab で比較基準色 #336699 を使い、カラーピッカー、CSS、シェーダーの値を照合します。8通りの表記と往復変換の精度を確認できます。