用途
w-a11y 用于对指定 UI 进行无障碍审计,依据的是仓库自身的无障碍(a11y)文档和已有的 a11y 测试,而非外部标准。它的定位是审查与报告,避免在未获授权时直接修改代码。
主要能力
- 依据仓库中的测试与前端文档,定位并核对被指定的 a11y 关卡(gate)。
- 检查变更 UI 的语义结构、键盘访问、元素名称与焦点管理。
- 运行仓库自带的无障碍或组件测试。
- 在获得修复授权时,应用满足文档化关卡的最小语义/ARIA 改动。
使用方式
对指定的 UI 执行审计。默认保持 report-only(仅报告)模式,除非用户要求修复。
若仓库中不存在与所指定 a11y 关卡相关的测试或前端文档,应报告这一情况,并只运行仓库中已有的测试。
不得声明 WCAG A/AA/AAA 等级,除非仓库文档中明确写出该等级。
若行为或命令发生变化,可参考文档 /w-docs。
适用场景
- 需要对变更后的 UI 进行无障碍合规性核对。
- 希望以仓库既有文档与测试为准绳、而非自行引入外部标准的团队。
限制
- 默认不进行修复,仅在用户授权后才应用最小改动。
- 不自行判定 WCAG 等级;仓库文档未写明等级时,不得宣称任何等级。
- 关于支持的平台、是否收费、价格等信息,资料未提供。