无障碍审核员 是做什么的?
审核Web应用的无障碍合规性(WCAG 2.1 Level AA)并提供改进建议。
何时使用
- 构建或审核UI组件
- 用户请求无障碍改进
- 准备无障碍审计
- 用户提及“无障碍”、“a11y”、“WCAG”、“屏幕阅读器”或“键盘导航”
操作指南
1. 语义化HTML检查
使用正确的HTML元素:
<!-- 错误 -->
<div onclick="submit()">提交</div>
<!-- 正确 -->
<button onclick="submit()">提交</button>
语义化结构:
<header>、<nav>、<main>、<footer><article>、<section>、<aside><h1>到<h6>按正确层级排列<button>用于操作,<a>用于导航
2. ARIA属性
何时使用ARIA:
- 自定义组件(标签页、手风琴、模态框)
- 动态内容更新
- 复杂交互
- 语义化HTML不足以表达时
常用ARIA属性:
<!-- 地标角色 -->
<nav role="navigation" aria-label="主导航">
<!-- 组件角色 -->
<div role="button" tabindex="0" aria-pressed="false">
<!-- 实时区域 -->
<div role="alert" aria-live="assertive">发生错误</div>
<!-- 标签和描述 -->
<button aria-label="关闭对话框">×</button>
<input aria-describedby="password-help" />
ARIA第一条规则: 如果语义化HTML可行,就不要使用ARIA
3. 键盘导航
所有交互元素必须支持键盘操作:
// 为自定义元素添加键盘支持
<div
role="button"
tabindex="0"
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
handleClick();
}
}}
>
点击我
</div>
Tab键顺序:
- 使用
tabindex="0"用于自定义交互元素 - 避免使用
tabindex > 0(会导致混乱的Tab键顺序) - 仅使用
tabindex="-1"实现编程焦点管理
焦点管理:
- 可见的焦点指示器
- 在模态框中锁定焦点
- 关闭对话框时返回焦点
- 主要内容跳过链接
4. 替代文本和图片
信息性图片:
<img src="chart.png" alt="第三季度销售额增长25%" />
装饰性图片:
<img src="decoration.png" alt="" />
<!-- 或 -->
<img src="decoration.png" role="presentation" />
复杂图片:
<figure>
<img src="complex-chart.png" alt="季度销售图表" />
<figcaption>
图表数据的详细描述...
</figcaption>
</figure>
5. 颜色和对比度
对比度比率(WCAG AA):
- 普通文本:最低 4.5:1
- 大号文本(18pt及以上):最低 3:1
- UI组件:最低 3:1
不要仅依赖颜色:
<!-- 错误:仅使用颜色 -->
<span style="color: red;">错误</span>
<!-- 正确:图标 + 颜色 -->
<span style="color: red;">
<svg aria-hidden="true"><!-- 错误图标 --></svg>
<span class="sr-only">错误:</span>
输入无效
</span>
6. 表单和标签
每个输入框都需要标签:
<!-- 显式标签 -->
<label for="email">邮箱</label>
<input id="email" type="email" />
<!-- 隐式标签 -->
<label>
邮箱
<input type="email" />
</label>
<!-- 图标按钮的 aria-label -->
<button aria-label="搜索">
<svg><!-- 搜索图标 --></svg>
</button>
错误消息:
<input
id="password"
aria-invalid="true"
aria-describedby="password-error"
/>
<div id="password-error" role="alert">
密码必须至少8个字符
</div>
7. 标题和文档结构
正确的标题层级:
<h1>页面标题</h1>
<h2>第一部分</h2>
<h3>子部分 1.1</h3>
<h3>子部分 1.2</h3>
<h2>第二部分</h2>
不要跳过层级: h1 → h2 → h3(不要 h1 → h3)
8. 动态内容
向屏幕阅读器宣布更新:
<!-- 礼貌:等待用户暂停 -->
<div role="status" aria-live="polite">
5条新消息
</div>
<!-- 断言:立即打断 -->
<div role="alert" aria-live="assertive">
您的会话将在1分钟后过期
</div>
加载状态:
<button aria-busy="true" aria-label="加载中...">
<span aria-hidden="true">加载</span>
</button>
9. 屏幕阅读器测试
仅屏幕阅读器可见的文本:
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
隐藏装饰性元素:
<svg aria-hidden="true"><!-- 图标 --></svg>
10. 常见检查问题
缺失:
- 图片的替代文本
- 表单输入框的标签
- 正确的标题层级
- 键盘焦点指示器
- 图标按钮的ARIA标签
不当:
- 低对比度文本
- 非语义化标记(用div作为按钮)
- 模态框缺少焦点管理
- 键盘陷阱
- 自动播放媒体
测试:
- 仅键盘导航
- 屏幕阅读器(NVDA、JAWS、VoiceOver)
- 色盲模拟
- 放大至200%
- 自动化工具(axe、Lighthouse)
11. 自动化测试
工具:
# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility
# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com
# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com
测试中集成:
import { axe } from 'jest-axe';
test('不应有无障碍违规项', async () => {
const { container } = render(<MyComponent />);
const results = await axe(container);
expect(results).toHaveNoViolations();
});
12. WCAG 2.1 Level AA检查清单
可感知:
- 非文本内容的文本替代
- 音频/视频的字幕
- 内容可适配(语义化标记)
- 足够的颜色对比度
可操作:
- 键盘可访问
- 无键盘陷阱
- 足够的时间限制(可调节)
- 无诱发性癫痫的闪烁
- 跳过导航链接
- 描述性页面标题
- 焦点顺序合理
- 链接目的从上下文明确
可理解:
- 指定页面语言(
<html lang="en">) - 可预测的导航
- 输入辅助(标签、说明、错误消息)
稳健:
- 有效的HTML
- 自定义组件的名称、角色、值
- 与辅助技术兼容
最佳实践
- 从一开始就构建无障碍
- 使用真实的辅助技术进行测试
- 优先使用语义化HTML,其次是ARIA
- 保持逻辑文档结构
- 提供多种访问内容的方式
- 彻底测试键盘导航
- 不要禁用页面缩放
- 使用地标和标题
支持文件
reference/wcag-checklist.md:完整的WCAG 2.1 AA检查清单reference/aria-patterns.md:常见的ARIA组件模式


