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 v3 テーマを v4 OKLCH へ変換

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 フォールバック表示も確認。

アクセシブルな OKLCH 50–950 スケール作成

このガイドで使用するツール

関連フォーマット

よくある質問

CSS oklch() を使うと古いブラウザで表示が崩れませんか?

2023 年以降の Chrome・Safari・Firefox・Edge はすべてネイティブ対応しています。旧環境向けには Hex 変数併用も可能です。

標準 sRGB モニターでは元の Hex と同じ色に見えますか?

はい、sRGB からの等価変換であれば Display P3 へ彩度を広げない限り完全に同じ見え方になります。

その他のガイド