Hex 轉 OKLCH:將設計 Token 平滑遷移至 Tailwind CSS v4
逐步說明如何將舊版 Tailwind v3 Hex/HSL 配置升級為 CSS Color 4 @theme oklch() 色階,兼顧亮度一致與 Display P3 支援。
約 6 分鐘 閱讀 · 更新於 2026-11-22
摘要比較
| 比較項目 | 舊版 Hex / HSL (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| 設定語法 | tailwind.config.js Hex 字串 | CSS @theme --color-* : oklch(...) |
| 感知亮度均勻度 | 否——黃色遠比藍色明亮 | 是——L 軸直接對應人眼明度 |
| Display P3 廣色域 | 侷限於 8 位元 sRGB | 原生支援 Display P3 與 Rec.2020 |
| 動態明暗變化 | 需仰賴前置編譯外掛 | 原生 CSS oklch(from var(--c) ... ) |
為什麼 Tailwind v4 全面改用 OKLCH 作為預設色板
傳統 sRGB Hex 隱藏了真實的視覺亮度,同為 500 階的黃與藍在對比度測試上往往差距甚大。
OKLCH 將感知亮度 L 獨立置於首個參數,搭配彩度 C 與色相 H,讓各色相按鈕與徽章在視覺重量上維持高度一致。
- 50–950 對比階梯精準可控:深字配 50–400、白字配 600–950。
- 無需 Sass 或 PostCSS 色彩外掛即可使用原生相對色彩。
將 tailwind.config.js 對應成 CSS @theme 宣告
將既有的 theme.extend.colors 或 :root CSS 變數貼入 Colr 轉換器,系統會自動計算精準 D65 sRGB 至 oklch() 數值。
在高亮階梯 (50–100) 適度收斂彩度可避免超出一般 sRGB 顯示器範圍。
將 tailwind.config.js 對應成 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 對比
上線前請用對比度矩陣檢視 500 與 600 主色階梯搭配白字的可讀性分數。
使用 Colr 的 OKLCH 色階工具可即時標出 AA 與 APCA Lc 安全邊界。
- 確認 500 與 600 階梯符合按鈕 4.5:1 基本文字對比。
- 檢查廣色域色彩在 sRGB 螢幕下的回退效果。
本指南涉及的工具
相關格式
常見問題
CSS oklch() 在現代瀏覽器相容性足夠嗎?
2023 年後的所有現代 Chrome、Safari、Firefox 與 Edge 皆已原生支援 oklch()。
在一般 sRGB 螢幕上看起來會跟原本 Hex 一樣嗎?
是的,直接換算的 oklch() 與原 Hex 呈現完全相同的色彩,直到刻意提升 C 進入 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 規範建立跨工具色彩 Token,完整保留 OKLCH 與 Display P3 並匯出 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 宣告與著色器。比較八種表示法,找出來回轉換時的精度損失。