/accessibility-review
若看到不熟悉的佔位符號或需要確認哪些工具已連線,請參閱 CONNECTORS.md。
對設計或頁面執行 WCAG 2.1 AA 無障礙合規審核。
使用方式
/accessibility-review $ARGUMENTS
為 @$1 進行無障礙審核
WCAG 2.1 AA 快速參考
可感知
- 1.1.1 非文字內容需有替代文字
- 1.3.1 資訊與結構需以語意方式傳達
- 1.4.3 對比度 >= 4.5:1(一般文字),>= 3:1(大型文字)
- 1.4.11 非文字對比度 >= 3:1(UI 元件、圖形)
可操作
- 2.1.1 所有功能可透過鍵盤操作
- 2.4.3 邏輯焦點順序
- 2.4.7 可見的焦點指示器
- 2.5.5 觸控目標大小 >= 44x44 CSS 像素
可理解
- 3.2.1 焦點觸發時可預測(無意外變更)
- 3.3.1 錯誤識別(描述錯誤)
- 3.3.2 輸入欄位需有標籤或說明
穩健
- 4.1.2 所有 UI 元件需有名稱、角色、值
常見問題
- 色彩對比不足
- 缺少表單標籤
- 互動元素無法用鍵盤操作
- 重要圖片缺少替代文字
- 模態框中的焦點陷阱
- 缺少 ARIA 地標
- 自動播放媒體無控制項
- 時間限制無延長選項
測試方法
- 自動掃描(約可發現 30% 的問題)
- 僅用鍵盤導航
- 螢幕閱讀器測試(VoiceOver、NVDA)
- 色彩對比驗證
- 縮放至 200% — 版面是否崩壞?
輸出
## 無障礙審核報告:[設計/頁面名稱]
**標準:** WCAG 2.1 AA | **日期:** [日期]
### 摘要
**發現問題數:** [X] | **嚴重:** [X] | **重大:** [X] | **輕微:** [X]
### 發現結果
#### 可感知
| # | 問題 | WCAG 準則 | 嚴重程度 | 建議 |
|---|-------|---------------|----------|----------------|
| 1 | [問題] | [1.4.3 對比度] | 🔴 嚴重 | [修正] |
#### 可操作
| # | 問題 | WCAG 準則 | 嚴重程度 | 建議 |
|---|-------|---------------|----------|----------------|
| 1 | [問題] | [2.1.1 鍵盤] | 🟡 重大 | [修正] |
#### 可理解
| # | 問題 | WCAG 準則 | 嚴重程度 | 建議 |
|---|-------|---------------|----------|----------------|
| 1 | [問題] | [3.3.2 標籤] | 🟢 輕微 | [修正] |
#### 穩健
| # | 問題 | WCAG 準則 | 嚴重程度 | 建議 |
|---|-------|---------------|----------|----------------|
| 1 | [問題] | [4.1.2 名稱、角色、值] | 🟡 重大 | [修正] |
### 色彩對比檢查
| 元素 | 前景色 | 背景色 | 比率 | 要求 | 通過? |
|---------|-----------|------------|-------|----------|-------|
| [主體文字] | [顏色] | [顏色] | [X]:1 | 4.5:1 | ✅/❌ |
### 鍵盤導航
| 元素 | Tab 順序 | Enter/Space | Escape | 方向鍵 |
|---------|-----------|-------------|--------|------------|
| [元素] | [順序] | [行為] | [行為] | [行為] |
### 螢幕閱讀器
| 元素 | 朗讀內容 | 問題 |
|---------|-------------|-------|
| [元素] | [螢幕閱讀器說的話] | [若有問題] |
### 優先修正
1. **[嚴重修正]** — 影響 [誰] 並阻礙 [什麼]
2. **[重大修正]** — 為 [誰] 改善 [什麼]
3. **[輕微修正]** — 建議事項
若已連線可用工具
若 ~~設計工具 已連線:
- 直接從 Figma 檢查色彩值、字體大小和觸控目標
- 檢查設計規格中的元件 ARIA 角色和鍵盤行為
若 ~~專案管理工具 已連線:
- 為每個無障礙發現結果建立工單,標註嚴重程度與 WCAG 準則
- 將發現結果連結至現有的無障礙改善史詩
小技巧
- 從對比度與鍵盤開始 — 這些能捕捉最常見且影響最大的問題。
- 使用真實輔助科技測試 — 我的審核是很好的起點,但搭配 VoiceOver/NVDA 手動測試能發現我無法察覺的問題。
- 依影響程度排定優先順序 — 先修正阻礙使用者的問題,再處理微調項目。