用途:在改动或审查 Payload 渲染 UI、交互与焦点行为、语义标记、无障碍测试或 WCAG/VPAT 证据时使用。核心原则是把无障碍评估作为变更的一部分,而非事后补做的扫描,并将结论限定在实际评估过的行为与状态范围内。
主要能力与要求:对每个受影响的组件或流程,先识别变更可能影响的渲染状态、输入方式、视口条件和辅助技术行为;阅读 wcag-2.2-aa.md,评估所有可能受影响的 WCAG 2.2 A 级与 AA 级标准,不局限于 issue 中提到的标准;优先使用原生 HTML 语义,若必须使用复合 ARIA 模式,应实现完整语义与键盘行为,而非孤立添加角色或状态;阅读 testing.md,依据可观察结果选择证据;在每个相关状态下实际演练变更行为,检查须覆盖生产组件与集成环境,而非简化替代品。
测试放置:浏览器可观察、标准级别的证据放入 test/a11y/WCAG.e2e.spec.ts,置于对应主要标准的数字顺序 test.describe 组内;依赖合成语音或屏幕阅读器虚拟/浏览光标的证据放入 test/a11y/screen-reader.spec.ts,按相同标准组织;两者共用的设置放入 test/a11y/helpers.ts,场景专属设置留在各自 spec 中;验证实现契约的底层单元测试放在组件旁,但不能替代端到端 WCAG 回归。复用现有 test/a11y 的 Payload 配置与真实 UI 组件,默认不新建无障碍 fixture 或标准文件。
证据边界:Axe 只能发现部分机器可检测的失败,扫描干净不等于符合标准或产品合规;DOM 与无障碍树断言不能证明确切朗读输出;Guidepup 仅用于确实依赖屏幕阅读器输出或光标行为的结果;仅当结果依赖判断、时序、平台行为或自动化难以复现的交互时,才要求人工视觉或辅助技术确认;WCAG 2.2 AA 合规需满足所有适用的 A 级与 AA 级标准,VPAT/ACR 合规声明须由合格人工审查者批准。
交接报告:需说明评估的 UI、状态与交互方式;评估的 WCAG 2.2 A/AA 标准及适用原因;运行的自动化测试与命令及结果;所需的人工视觉、屏幕阅读器或其他验证;已知失败、限制及尚无法支持的标准。不得超出所收集证据报告组件、标准或产品合规。