无障碍实践指南

无障碍审计:找出 HTML 障碍,再验证真实操作流程

静态审计能为标签、图片替代文本和文档结构提供有用证据。本文说明如何把发现转化为组件修复,并验证仅凭 HTML 无法证明的交互行为。

展示无障碍页面结构、键盘移动路径和具名控件的概念插图,并非产品实际截图。
概念插图

购买按钮可能看起来很完善,却没有易于理解的无障碍名称。表单可能展示了全部必填字段,却仍让用户猜测应该输入什么。关键是用户能否完成任务,而不是评分显示什么颜色。

请审计自己拥有或获准检查的页面,并把报告与浏览器放在一起查看。静态分析与真实使用测试提供的是不同证据。问题列表很短或评分呈绿色,都不能证明页面完全符合 WCAG。

此审计的范围

可以测量什么

  • 一个指定页面的静态 HTML,包括标签、名称、替代文本和文档结构线索。
  • 与焦点、表单、框架、表格和媒体有关的部分标记模式。
  • 内联样式中明确指定的部分文字颜色与背景颜色组合。

不能证明什么

  • 不完整执行交互流程,也不使用屏幕阅读器进行操作测试。
  • 不全面评估计算后的 CSS 颜色及所有视觉状态。
  • 不提供 WCAG 认证,也不证明法律合规。

无障碍模块适用于 Starter、Professional 和 Enterprise,Free 不包含此模块。手动检查步骤可以独立于订阅执行。

从重要任务开始

选择一个具体流程,例如申请报价、创建账户、阅读规格或联系支持。记录准确的 URL、页面语言和预期完成结果。同时说明页面是否公开,还是需要登录。公开页面的审计不能验证登录后的完整操作流程。

先检查一个有代表性的页面,再分别检查其他模板。共享导航中的缺陷可能影响许多页面;首页没有警告,并不能说明订单表单或弹窗可用。应优先解决阻碍任务完成的问题,再处理外观整理。发现的严重程度应根据使用情境及其实际影响判断,而不能仅由分数决定。

理解实际测量了什么

目前 Sitelemetry 的检查引擎分析一个页面的静态 HTML。检查内容包括图片缺少替代文本、文档标题或语言缺失、可能没有标签的表单字段、没有名称的链接或按钮、标题顺序问题、缺少主要区域、正值 tabindex 和重复 ID 等。部分检查属于启发式判断,需要进一步确认。

引擎也检查部分内联颜色组合,但这不是完整的对比度评估。继承的 CSS、背景图片、叠加层和交互状态可能不在范围内。抓取失败、中间验证页面、内容截断或非 HTML 响应会导致评估不可用或不适用,而不表示通过无障碍检查。W3C 的工具选择指南解释了为什么仍然需要人工判断。

分配修复任务前先读证据

可执行的修复任务应注明 URL、受影响元素或示例、待验证行为,以及可能被阻断的任务。“三张图片缺少 alt”比“改善无障碍”更具体。但替代文本存在,并不证明它正确描述了图片的作用。

请在浏览器中确认有歧义的发现。静态模式可能漏掉包裹输入框的标签,也可能接受指向不存在元素的 aria-labelledby。应在无障碍树中查看实际计算出的名称。标题顺序警告也需要结合内容审阅,不能直接当作对全部 WCAG 要求的判决。对于重复出现的问题,应按共享组件归类,而不是逐页孤立修补。

观察结果情境中的优先级需要确认的证据下一步
必填字段没有可用名称阻碍重要任务时优先级高检查计算后的名称并完成表单修复标签关联,再重复操作
图片缺少替代内容取决于图片目的判断是信息、功能还是装饰写入合适替代内容;装饰图片使用空alt
标题顺序警告需结合上下文审阅阅读文档结构与内容如果妨碍理解,修复共享结构

修复源头组件

优先使用原生 HTML 控件和可见标签。显式关联时,for 必须指向正确字段的 ID。占位文字会在输入过程中消失,不能替代可靠的标签。W3C 表单标签教程说明了适当的关联方式。对于只有图标的按钮,应使用“打开搜索”这类描述操作的名称,而不只是说明图形本身。

根据图片的目的决定替代内容:传达信息、触发操作,还是纯粹装饰。功能性图片需要恰当的替代文本;纯装饰图片可以使用空替代文本。不要为了消除警告而把所有文本清空。参考 W3C 图片教程,修复组件或内容模型,避免新增内容继续重复同类问题。

补充浏览器检查

  1. 仅使用键盘到达并激活控件。确认焦点可见、移动顺序合理,并能退出对话框。
  2. 使用屏幕阅读器检查标题、名称、说明和错误。重点是能否理解任务,而不只是有没有文字被读出。
  3. 测量正常、悬停、聚焦和错误等相关状态的对比度,同时检查图片和叠加层。
  4. 测试放大显示及狭窄视口,寻找消失的控件和难以使用的滚动方式。

这些是补充使用测试,不是声称静态引擎已经执行的能力。W3C 初步检查可以作为起点。根据服务的重要性,邀请具有不同访问需求的用户参与验证。

复测并记录剩余范围

修改后,在同一 URL 上重新运行审计并比较具体证据。共享组件是否已修复?是否引入新的名称或结构问题?同时重复最初选择的手动流程。如果警告消失了,但对话框依然无法用键盘操作,就不能认定修复完成。

记录日期、页面和修改内容,并分别列出静态与手动结果。在面向客户的报告中,说明检查过哪些模板和交互,以及哪些不在范围内。分数既不是能够成功操作的用户百分比,也不是法律证明。保留尚待执行的手动检查,并把关键流程纳入后续发布前的检查。

常见问题

高分能证明符合 WCAG 吗?

不能。评分反映的是声明范围内所检查的模式。交互、内容和其他要求仍需额外的专业评估与手动检查。

每张图片都需要描述性替代文本吗?

取决于目的和上下文。信息性与功能性图片需要合适的替代内容;纯装饰图片使用空替代文本可能是正确做法。

审计能确认弹窗可用吗?

它可以从已获取的标记中发现线索,但不会打开弹窗进行操作。键盘路径、焦点管理和屏幕阅读器中的可理解性需要单独验证。

来源与延伸阅读

  1. W3C:选择评估工具www.w3.org
  2. W3C:为表单控件添加标签www.w3.org
  3. W3C:图片与替代文本www.w3.org
  4. W3C:无障碍初步检查www.w3.org
Sitelemetry 团队

由 Sitelemetry 团队根据产品审计范围和链接的一手资料编写。除明确标注的实际观察案例外,示例均用于说明。

SITELEMETRY

将指南付诸实践。

查看报告中的证据,修复根本原因,然后重新运行相关检查。

打开 Sitelemetry