自动化扫描抓不到所有语义问题,却能稳定拦住那些重复出现、修复成本低的缺陷。对高频生成的界面,这条防线的价值尤其高。

01扫描要覆盖真实状态

只扫首屏远远不够:菜单展开、对话框打开、表单提交报错、异步内容加载完成,都是违规高发状态。用 Playwright 驱动页面走一遍关键交互,在每一步之后各跑一次 axe 分析,并把结果数量与规则 ID 输出为可追溯的报告。对使用组件库的项目,还应在组件示例页单独扫描一遍,让问题在最早的位置暴露。

写文档时把「CI 扫描」的结论、适用前提与验证日期一并记下。浏览器能力与合规要求都在快速变化,一条带日期的记录,比一句没有上下文的「最佳实践」更能帮未来的维护者做出正确决定。

02规则配置与阻断策略

按 WCAG 版本与级别选择 tag,先启用一组核心规则并设为阻断,再逐步扩大范围,避免一次性抛出上百条告警导致团队直接忽略。为暂时无法修复的项建立带负责人、原因与复测日期的例外清单,禁止用全局 disable 一笔带过。静态 lint 负责编码阶段,渲染后扫描负责运行阶段,两者结果应汇总到同一处看板。

写文档时把「CI 扫描」的结论、适用前提与验证日期一并记下。浏览器能力与合规要求都在快速变化,一条带日期的记录,比一句没有上下文的「最佳实践」更能帮未来的维护者做出正确决定。

03别把通过当成合规

自动化只能发现可机器判定的子集;可访问名称是否贴切、读屏顺序是否符合任务、错误信息是否说清下一步,仍需键盘与辅助技术人工验证。正确的定位是「最低防线」:它保证重复的低级错误不再流入生产,把有限的人工评审时间留给真正需要判断的部分,并形成带环境版本与日期的证据链。

写文档时把「CI 扫描」的结论、适用前提与验证日期一并记下。浏览器能力与合规要求都在快速变化,一条带日期的记录,比一句没有上下文的「最佳实践」更能帮未来的维护者做出正确决定。

要点速览

  • 在菜单展开、弹窗、表单报错、异步完成后各扫一次
  • 按 WCAG tag 配置规则,核心项阻断、例外项带复测日期
  • 静态 lint 与渲染后扫描结果汇总到同一看板
  • 自动化是子集,人工键盘与读屏验证不可省略

先让机器拦住能拦的,人才有精力判断该判断的。