與工藝相伴的無障礙設計
無障礙不是事後才加上去的合規勾選框;它是介面工藝的基礎。大部分無障礙功能在使用平台原生元素時是免費的:原生元素內建鍵盤支援、真正的標籤會自行宣告、可見的焦點環也只需一條 CSS 規則。在建立或審查 UI 程式碼時應用這些原則,並在套用修復時配合專案現有的樣式系統(Tailwind、純 CSS 或 CSS-in-JS)。
進行審查時,首先以純鍵盤使用者的身份操作介面(每個流程都必須能在沒有滑鼠的情況下完成),然後以螢幕閱讀器使用者的身份操作:每個控制項是否都會宣告其名稱、角色和狀態?如果不確定,優先使用平台預設值,而非自訂重建,並移除 ARIA 而非新增。
已渲染配對的對比度測量與色彩修正由 better-colors 技能負責;視覺文字大小與 iOS 輸入縮放由 better-typography 負責;空間 RTL 佈局由 better-layout 負責。
快速參考
| 類別 | 使用時機 |
|---|---|
| 焦點與鍵盤 | 焦點環、跳至內容連結、tabindex、焦點陷阱、APG 鍵盤模式 |
| 語意與 ARIA | 優先使用原生元素、button 與 link、地標、可存取名稱、停用狀態 |
| 表單 | 標籤、自動填入、錯誤訊息、輸入類型 |
| 螢幕閱讀器 | 視覺隱藏內容、即時區域、提示訊息、替代文字、SVG |
| 點擊區域 | 目標尺寸、擴大點擊區域、碰撞規則 |
| 動畫與縮放 | prefers-reduced-motion、自動播放與計時 UI、200% 縮放、重新排版、rem 與 px |
核心原則
1. 優先使用原生元素
ARIA 的第一條規則:當原生元素存在時,不要使用 ARIA。動作使用 <button>,導航使用 <a href>(它必須支援 Cmd/Ctrl/中鍵點擊),絕不使用 <div onClick>。沒有 ARIA 勝過錯誤的 ARIA。
2. 可見的焦點環
樣式化 :focus-visible,而非單純的 :focus,這樣鍵盤使用者會看到焦點環,而滑鼠使用者通常不會。優先使用瀏覽器未修改的焦點指示器。如果設計需要自訂焦點環,請使用專案的焦點 token 或其他明確的顏色,並驗證完整的指示器與其跨越的每個相鄰顏色;currentColor 僅在經過相同檢查後才可接受。使用至少 2px 的實心邊框或等效的可見區域。切勿在沒有經過驗證的替代方案的情況下使用 outline: none,並在 forced-colors 模式下保留系統顏色。
3. 完整的鍵盤支援
每個指標互動都需要一個鍵盤路徑,遵循 ARIA APG 模式:Escape 關閉覆蓋層,方向鍵在複合 widget(標籤頁、選單、清單方塊)內移動,Tab 在 widget 之間移動,Enter 和 Space 啟動操作。僅使用 tabindex="0"(加入自然 Tab 順序)和 tabindex="-1"(程式化焦點),絕不使用正數值,因為這會破壞自然順序。複合 widget 使用 roving tabindex:活動項目為 0,其他所有項目為 -1。
4. 捕捉與恢復焦點
模態框在背景內容上設定 inert,開啟時將焦點移入,關閉時將焦點返回觸發按鈕。加上 overscroll-behavior: contain,避免背景內容滾動。
5. 最小點擊區域
WCAG 2.5.8 的 AA 級基準是 24×24 CSS 像素的目標,或其一項已定義的間距、等效控制項、內聯、使用者代理或必要例外。為更輕鬆的啟動,在觸控情境中目標為 44×44px,在桌面介面中若密度允許則為 40×40px。如果可見元素應保持較小,可使用偽元素來延伸。切勿讓延伸的點擊區域重疊。
6. 標記每個控制項並設定類型
每個輸入都應有 <label for> 或包裹的 <label>;預留位置文字絕不是標籤,且標籤與控制項共享一個點擊目標:複選框與其文字之間沒有死區。為輸入加上 autocomplete 並使用有意義的 name,以及正確的 type 和 inputmode 以對應鍵盤。絕不封鎖貼上;使用者會貼上密碼和一次性驗證碼。
7. 會宣告的錯誤
保持提交按鈕啟用直到請求開始,然後在顯示旋轉圖示時將其停用,同時保留原始標籤。在提交時驗證:為失敗的欄位加上 aria-invalid="true",將 aria-describedby 指向內聯錯誤文字,並將焦點移到第一個無效欄位。當原生控制項確實無法使用時,使用原生 disabled。僅在有意保留可聚焦性或可發現性時,才使用 aria-disabled="true";然後在程式碼中阻斷指標、鍵盤和表單行為,並明確設定狀態樣式。
8. 無處不在的可存取名稱
僅有圖示的按鈕需要一個描述性的 aria-label。可見的標籤文字必須出現在可存取名稱中。裝飾性元素加上 aria-hidden="true",絕不能加在可聚焦元素上。
9. 不要僅依賴顏色
狀態需要一個冗餘提示:與顏色一起使用的圖示、文字或底線。根據內容和狀態判斷適用的 WCAG 對比度要求,然後使用 better-colors 測量已渲染的前景/背景配對。當對比度失敗時,回報該配對及其未達到的要求;除非被要求,否則不要更改專案的顏色。
10. 尊重 prefers-reduced-motion
將動畫包裹在 @media (prefers-reduced-motion: no-preference) 中,使其成為選擇加入。在減少動畫設定下,用透明度淡入淡出取代滑動和縮放;完全移除視差和自動播放。不論偏好設定為何:自動播放的媒體需要一個可見的暫停控制項,而帶有動作或錯誤的提示訊息則需保留直到被關閉。
11. 宣告動態內容
使用 aria-describedby 進行欄位特定的驗證,使用禮貌的即時區域(role="status")進行非緊急、未綁定控制項的更新(如提示訊息或結果計數),僅對未綁定控制項的緊急錯誤使用 role="alert"。為確保可靠的重复禮貌宣告,在更新文字前先渲染一個穩定的空白區域;動態插入的警示有不同的支援度,必須使用目標螢幕閱讀器進行測試。
12. 按用途提供替代文字
裝飾性圖片使用 alt="",資訊性圖片描述其意義,功能性圖片描述其動作:搜尋圖示按鈕是 alt="搜尋",而不是 alt="放大鏡"。
13. 結構即導航
使用描述其章節並形成連貫大綱的標題;一個頁面層級的 <h1> 和正確巢狀層級是建議的預設值,而非獨立的 WCAG 通過/失敗規則。公開一個可見的主要 <main> 地標。當重复的導航或 chrome 在其之前時,使「跳到主要內容」連結成為第一個可聚焦元素。帶有錨點的標題加上 scroll-margin-top。
14. 能在縮放與文字大小調整下存活
頁面必須在 200% 縮放下運作,並在 320px 寬度下重新排版而不產生水平滾動。在文字容器上使用 min-height 而非固定 height,優先使用符合程式碼庫慣例的 rem 斷點,並保持 viewport meta 不限制使用者可縮放的程度。
常見錯誤
| 錯誤 | 修正 |
|---|---|
使用 outline: none 移除焦點環 | 改為設定 :focus-visible 的樣式;滑鼠點擊不會顯示它 |
| 自訂焦點顏色假設到處都有效 | 驗證完整指示器與每個相鄰顏色以及在 forced-colors 模式下 |
使用 <div onClick> 作為按鈕或連結 | 動作使用 <button>,導航使用 <a href> |
| 僅使用預留位置作為標籤 | 加上可見的 <label for>;預留位置在輸入時會消失 |
使用正數 tabindex 來修正焦點順序 | 修正 DOM 順序;僅使用 0 和 -1 |
| 重複的禮貌更新不一致地宣告 | 保持一個穩定的空白狀態區域並更新其文字;測試目標螢幕閱讀器 |
為例行提示訊息使用 assertive 即時區域 | 使用 polite;為錯誤保留 assertive |
在可聚焦元素上使用 aria-hidden="true" | 移除它或使元素不可聚焦 |
| 功能性圖示的替代文字描述圖片 | 描述動作:alt="搜尋",不是 alt="放大鏡" |
| 在表單有效前停用提交按鈕 | 保持啟用;在提交時驗證並將焦點移到第一個錯誤 |
審查輸出格式
僅在使用者要求獨立無障礙審查時使用此格式。當 better-interface 協調審查時,請向該技能提供領域證據和發現,並讓其輸出格式、嚴重性評分、合併規則、上限和判定優先。
將獨立審查分為兩部分呈現。
發現
按原則分組所有已確認的發現。使用帶有嚴重性、位置、之前、之後和原因欄位的 Markdown 表格。切勿使用單獨的「之前:」/「之後:」行。
- 嚴重性:
HIGH會阻止任務、向輔助科技隱藏內容,或造成系統性的無障礙失敗;MEDIUM會顯著增加互動難度;LOW是孤立的打磨工作。 - 位置:引用
path/to/file:line。如果成品沒有原始檔案,請改為引用確切的畫面和元件。 - 之前 / 之後:顯示目前的實作和可行的替代方案。
- 原因:指出違反的原則及其對使用者的影響。
將重複的系統性問題合併為一行,並列出所有受影響的位置。省略沒有發現的原則。
範例
無處不在的可存取名稱
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| HIGH | src/Dialog.tsx:42 | <button><XIcon /></button> | 加上 aria-label="關閉";將圖示標記為 aria-hidden="true" | 僅有圖示的控制項沒有可存取名稱 |
| HIGH | src/Nav.tsx:18 | <a href="/settings"><GearIcon /></a> | 加上 aria-label="設定" | 螢幕閱讀器無法取得連結目的地 |
可見的焦點環
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| HIGH | src/button.css:12 | button:focus { outline: none; } | button:focus-visible { outline: 2px solid; outline-offset: 2px; } | 鍵盤使用者無法看到焦點 |
| HIGH | src/Menu.tsx:31 | focus:outline-none | focus-visible:outline-2 focus-visible:outline-offset-2 | 選單導航沒有可見的焦點指示器 |
會宣告的錯誤
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| HIGH | src/EmailField.tsx:27 | 僅以 border-red-500 顯示錯誤 | 加上 aria-invalid="true" + aria-describedby="email-error" 並附上內聯錯誤文字 | 僅靠顏色既無法解釋也無法宣告錯誤 |
| MEDIUM | src/SignupForm.tsx:64 | 在表單有效前停用提交按鈕 | 保持提交按鈕啟用;失敗時,將焦點移到第一個無效欄位 | 停用的動作隱藏了需要修正的內容 |
最小點擊區域
| 嚴重性 | 位置 | 之前 | 之後 | 原因 |
|---|---|---|---|---|
| MEDIUM | src/Toolbar.tsx:22 | size-4 僅有圖示的按鈕 | 使用 after:absolute after:size-11 將點擊區域擴大到 44×44px | 目標太小,無法進行可靠的觸控輸入 |
驗證與判定
在發現之後:
- 驗證:列出執行過的確切檢查及其觀察結果,包括鍵盤遍歷、可存取名稱檢查,以及在適用時的螢幕閱讀器或自動化檢查。如果某項檢查未執行,請說明仍需驗證的內容。
- 判定:如果存在任何
HIGH發現,則為封鎖;如果僅有MEDIUM或LOW發現,則為需要修改;僅在沒有可操作的發現時為核准。
當沒有發現時,省略表格,陳述「沒有可操作的無障礙發現」,回報驗證結果,並以 核准 結束。