網頁內容無障礙規範(WCAG)2.1 定義了精確的量化門檻,以確保患有輕中度視力受損或色覺障礙的使用者能清楚辨識文字資訊與介面輪廓。確認色彩是否合規,核心在於計算前景色與作為底層的背景色這兩個純色圖層之間的相對亮度比率。
WCAG 2.1 門檻標準
- 一般文字 AA 級(最低對比度):小於 18 點(24px)的一般內文文字,或小於 14 點(約 18.66px)的粗體文字,最低對比度比率必須達
4.5:1。 - 一般文字 AAA 級(加強對比度):一般內文排版文字對比度比率必須達
7.0:1以上。 - 大文字 AA 級:字級達 18 點(24px)以上的一般字重文字,或 14 點(18.66px)以上的粗體文字,對比度比率至少需達
3.0:1。 - 大文字 AAA 級:大字級排版文字對比度比率至少需達
4.5:1。 - 圖形物件與使用者介面元件(AA 級):表單控制項邊框、互動按鈕外框、焦點提示環(Focus Ring)以及具備語意的圖表圖形,與相鄰背景之間的對比度比率至少需達
3.0:1。
正式環境設計權杖範例
在現代設計系統中宣告色彩權杖時,建議將通過無障礙驗證的色彩組合對應至語意化 CSS 自訂屬性,確保主題切換時依然維持法規合規性:
:root {
/* 表面背景權杖 */
--color-surface-canvas: #ffffff;
--color-surface-subtle: #f8fafc;
--color-surface-inverted: #0f172a;
/* 文字權杖 - 於純白畫布上符合 WCAG AAA 規範(比率 > 7.0:1) */
--color-text-primary: #0f172a; /* 針對 #ffffff 達到 16.0:1 */
--color-text-secondary: #475569; /* 針對 #ffffff 達到 7.3:1 */
/* 文字權杖 - 於純白畫布上符合 WCAG AA 規範(比率 >= 4.5:1) */
--color-text-muted: #64748b; /* 針對 #ffffff 達到 4.6:1 */
/* 互動式 UI 元件權杖(比率 >= 3.0:1) */
--color-border-input: #94a3b8; /* 針對 #ffffff 達到 3.1:1 */
--color-focus-ring: #2563eb; /* 針對 #ffffff 達到 4.6:1 */
}
.btn-accessible {
background-color: var(--color-surface-inverted);
color: #ffffff; /* 16.0:1 比率 - 符合 AAA 規範 */
border: 1px solid var(--color-surface-inverted);
outline-offset: 2px;
}
.btn-accessible:focus-visible {
outline: 2px solid var(--color-focus-ring);
}
透過將字型排版與邊框顏色錨定至通過審查的權杖上,前端程式庫能在元件重新排版或在淺色與深色模式之間切換時,杜絕無意間產生的對比度違規現象。