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 | ✅/❌ |
### 键盘导航
| 元素 | 跳转顺序 | Enter/空格 | Escape | 箭头键 |
|------|----------|------------|--------|--------|
| [元素] | [顺序] | [行为] | [行为] | [行为] |
### 屏幕阅读器
| 元素 | 朗读内容 | 问题 |
|------|----------|------|
| [元素] | [屏幕阅读器读出的内容] | [问题(如有)] |
### 优先级修复
1. **[严重修复]** — 影响[谁],阻止[什么]
2. **[主要修复]** — 改善[什么],针对[谁]
3. **[次要修复]** — 锦上添花
如果连接器可用
如果 ~~设计工具 已连接:
- 直接从 Figma 检查颜色值、字号和触摸目标
- 在设计规范中检查组件的 ARIA 角色和键盘行为
如果 ~~项目跟踪工具 已连接:
- 为每个无障碍性发现创建工单,标注严重程度和 WCAG 标准
- 将发现链接到现有的无障碍性修复项目
提示
- 从对比度和键盘开始 — 这些能捕获最常见且影响最大的问题。
- 使用真正的辅助技术测试 — 我的审计是个好的开始,但使用 VoiceOver/NVDA 进行手动测试能发现我无法检测的问题。
- 按影响程度排序 — 先修复阻碍用户的问题,再优化细节。