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 v3 轉換為 v4 OKLCH

將 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 螢幕下的回退效果。

建立無障礙 OKLCH 50–950 色階

本指南涉及的工具

相關格式

常見問題

CSS oklch() 在現代瀏覽器相容性足夠嗎?

2023 年後的所有現代 Chrome、Safari、Firefox 與 Edge 皆已原生支援 oklch()。

在一般 sRGB 螢幕上看起來會跟原本 Hex 一樣嗎?

是的,直接換算的 oklch() 與原 Hex 呈現完全相同的色彩,直到刻意提升 C 進入 Display P3。

更多色彩指南