用途:帮助开发者构建键盘用户与辅助技术用户都能使用的 Web 界面,覆盖 WCAG 2.1/2.2 AA、语义化 HTML、ARIA、键盘与焦点管理、屏幕阅读器、对比度及测试。资料指出多数司法辖区以 AA 为法律基线(ADA、EN 301 549、AODA)。
主要能力与规则:优先使用原生元素(button、a、input、nav),ARIA 只描述不添加行为;不要覆盖原生语义;不要在可聚焦元素上单独使用 aria-hidden;不要在没有替代样式时移除焦点轮廓。可访问名称按 aria-labelledby、aria-label、原生标签、title/placeholder 的顺序解析,图标按钮必须命名。高频 AA 失败点包括图片 alt、对比度(正文 4.5:1、大字 3:1、UI 与焦点指示 3:1)、仅用颜色传达信息、320px 重排、键盘可达、焦点可见、名称/角色/值、表单标签与错误标识、html lang。WCAG 2.2 新增焦点不被遮挡、拖拽替代、目标尺寸 ≥24×24px、可访问认证等。
使用方式:按 WAI-ARIA APG 实现复合组件键盘模式;模态框保存并恢复焦点、Esc 关闭、背景 inert;SPA 路由切换后移动焦点或通过实时区域播报;实时区域需先存在于 DOM 再更新内容,polite 用于状态、assertive 仅用于错误。表单用 label 加 aria-describedby 关联提示与错误,并同步 aria-invalid。
测试与限制:自动化工具(jest-axe、@axe-core/playwright、eslint-plugin-jsx-a11y、Lighthouse、Pa11y)仅覆盖约 30–40% 问题,必须补充手动键盘与屏幕阅读器测试(NVDA+Firefox、VoiceOver+Safari 等)。资料未提供安装命令、收费或平台信息。