OKLCH 色彩
OKLCH 是一種感知均勻的色彩空間,其中的明度(Lightness)、彩度(Chroma)和色相(Hue)是可用的設計控制項。當專案已經使用 OKLCH、正在建立新的色彩系統,或者使用者要求轉換或調色板工作時,請使用它。否則,請保留專案既有的 Token 和標記法:一致性的 hex 或 RGB Token 系統優於為了一個孤立的修正而引入第二種色彩表示法。若要互動探索,請造訪 oklch.fyi。
快速參考
| 類別 | 使用時機 | 參考文件 |
|---|---|---|
| 轉換 | Hex/RGB/HSL 轉為 oklch | color-conversion.md |
| 調色板 | 生成階層、多色相、暗色模式 | palette-generation.md |
| 對比度 | APCA/WCAG 檢查、回報失敗、按要求修正 | accessibility-contrast.md |
| 色域與 Tailwind | P3 降級、@theme 階層、色域裁切 | gamut-and-tailwind.md |
| 使用 | 語意 Token、每種顏色一個意義、主要操作強調、外觀變體 | color-usage.md |
核心原則
1. 使用感知色彩空間
- 尊重既有系統。 不要因為載入此技能就轉換標記法。重複使用專案的語意 Token 和創作格式,除非任務包含色彩系統遷移。
- 感知均勻性。 相等的 L 步進 = 相等的亮度。
oklch(0.5 ...)在視覺上是中間值。HSL 的lightness: 50%會因色相而有極大差異。 - 穩定的色相。 HSL 的藍色在明度變化時會偏紫。OKLCH 的色相在整個明度範圍內保持恆定。
- 獨立的彩度。 彩度是色彩飽和度的絕對衡量,不依賴明度。HSL 的飽和度則會。
- 有限的色域。 並非每個 oklch 值都能對應到可顯示的 sRGB 色彩。某些色相的高彩度值會被裁切;必須具備色域意識。
2. 一致地撰寫和格式化 OKLCH
oklch(L C H)
oklch(L C H / alpha)
| 通道 | 範圍 | 描述 |
|---|---|---|
| L(明度) | 0–1 | 0 = 黑色,1 = 白色。感知均勻。 |
| C(彩度) | 0–約 0.4 | 色彩飽和度。0 = 灰色。最大值取決於 L 和 H。 |
| H(色相) | 0–360 | 色相角度,單位為度。 |
| alpha | 0–1 | 可選透明度。使用斜線語法。 |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
L 和 C 使用三位小數,H 最多三位小數。去除尾隨零並將 -0 格式化為 0。OKLCH 是 Baseline 2023;當支援需求異常廣泛時,請檢查目標專案的瀏覽器矩陣,而非依賴固定的全域覆蓋率百分比。
3. 測量對比度、色域和調色板行為
| 規則 | 值 |
|---|---|
| 亮/暗邊界 | L > 0.73 = 亮背景 → 暗文字;低於此值,亮文字仍獲得較高分數 |
| 明度差距(亮背景) | 當背景 L > 0.9 時,前景 L < 0.35 |
| 明度差距(暗背景) | 當背景 L < 0.25 時,前景 L > 0.9 |
| 色相偏移閾值 | 調色板階層間散布 > 10° = 明顯偏移 |
| APCA 正文 | |
| APCA 非正文 | |
| WCAG 2 一般文字 | 4.5:1 AA,7:1 AAA |
| 對比度修正(僅在要求時) | 先調整 L;盡可能保留 C 和 H,然後重新測量渲染對組合 |
常見錯誤
| 問題 | 修正方式 |
|---|---|
| 原始色彩繞過專案的語意 Token 系統 | 在專案既有標記法中重複使用或新增正確的角色 Token |
| 在 Hex/RGB 程式碼基底中孤立引入 OKLCH 值 | 保留既定標記法,除非任務包含色彩系統遷移 |
| 帶有色相偏移的 HSL 調色板漸層 | 使用恆定的 oklch 色相重建 |
| 對比度失敗(使用 APCA 檢查前景與其背景) | 回報該組合、其測得的 Lc 以及未達到的閾值;只有在要求時才更改顏色(然後調整 L,保留 C 和 H) |
| 未檢查色域的高彩度 | 針對 sRGB 中的 L/H 裁切至最大彩度 |
| 在不同色相使用相同的絕對 C | 使用相同的 C%(最大彩度的百分比)以獲得一致的鮮明度 |
| 沒有 sRGB 降級的 P3 色彩 | 添加 @media (color-gamut: p3) 模式 |
| 透過機械式反轉亮色調色板建立的暗色模式 | 以亮色調色板為起點,然後調整彩度和明度,並重新檢查每個前景/背景組合 |
Tailwind v4 @theme 中的 Hex | 轉換為 oklch 值 |
| 帶有逗號語法的 Alpha | 使用斜線:oklch(L C H / alpha) |
| 相同色相代表兩種不同意義(連結顏色被重複用於裝飾) | 一種顏色,一個意義;為第二個用途賦予中性色 |
| 語意 Token 用於其角色之外(分隔線用作文字) | 為缺少的角色新增 Token;永遠不要借用數值 |
| 一個檢視畫面中有多個彩色控制項背景 | 僅填充單一主要操作;次要操作保持中性 |
| 僅在亮色模式下驗證調色板 | 在兩種外觀中都重新檢查每個前景/背景組合 |
審查輸出格式
僅在使用者要求獨立色彩審查時使用此格式。當 better-interface 協調審查時,請向該技能提供領域證據和發現,並讓其輸出格式、嚴重性等級、合併規則、上限和裁決優先。
將獨立審查分為兩部分呈現。
發現事項
按原則分組所有已確認的發現事項。使用具有嚴重性、位置、之前、之後和原因欄位的 Markdown 表格。永遠不要使用單獨的「之前:」/「之後:」行。
- 嚴重性:
HIGH使內容無法閱讀或賦予誤導性的語意顏色;MEDIUM造成明顯的主題、色域或一致性失敗;LOW是孤立的潤飾。 - 位置:引用
path/to/file:line。如果工件沒有原始檔案,請改為引用確切的畫面和元件。 - 之前 / 之後:顯示當前數值或 Token 以及確切的替代值。
- 原因:指出違反的原則,並在相關時包含測量的對比度或色域證據。
將重複的系統性問題合併為一行,並列出所有受影響的位置。省略沒有發現事項的原則。
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | 新專案顏色使用 OKLCH Token |
| MEDIUM | src/palette.ts:31 | 不同色相使用相同絕對 C | 使用每個色相最大彩度的相同 C% | 相等的彩度值在不同色相中看起來不會同樣鮮明 |
| HIGH | src/theme.css:52 | 沒有降級的 P3 色彩 | 在 @media (color-gamut: p3) 之前添加 sRGB 降級 | 該顏色在非 P3 顯示器上失敗 |
驗證與裁決
在發現事項之後:
- 驗證:列出執行的確切檢查及其觀察結果,包括對比度測量、色域檢查以及在適用時同時檢查亮色和暗色外觀。如果某項檢查未執行,請說明仍需驗證的內容。
- 裁決:如果仍有任何
HIGH發現事項,則為Block;如果僅有MEDIUM或LOW發現事項,則為Needs changes;只有在沒有可處理的發現事項時才為Approve。
當沒有發現事項時,省略表格,陳述「沒有可處理的色彩發現事項」,報告驗證結果,並以 Approve 結尾。