审核 HTML 无障碍:基线、源码问题与浏览器证据
生成可重复的静态 HTML 问题清单,在相同页面范围比较修复,并保留尚未执行的实际检查。先运行离线示例,再应用到自己的应用。
快速开始
让 AI 助手帮你完成
将这段提示粘贴到你正在使用的 AI 助手中:
使用 Accessibility Review Studio 审核我获准的 HTML 源码。确认用户任务与页面范围,保留修改前报告,比较准确修正源码,区分已解决、持续、新增及移出范围的问题。检查每项问题的行号、摘录与源码哈希。未实际执行的检查保持 not-run,记录具体浏览器证据,仅以匹配源码哈希重新生成。交付清单与剩余审核范围,不宣称 WCAG 认证。不调用付费 API,不公开源码文件。
Accessibility Review Studio 检查什么?
Accessibility Review Studio v1.0.0 在获准 HTML 源码中检查有限的命名与结构问题,记录来源路径、行号、摘录及哈希,将修复与基线比较,并收集单独填写的浏览器观察。单独内容包价格为 US$4.99,使用 Python 3.10 及以上标准库离线运行。内置示例无需 API 密钥、付费扫描器或依赖安装。
源码检查器不执行 CSS 或 JavaScript,不检查运行时 DOM,也不证明完整 WCAG 符合性。问题清单为空,不代表键盘操作、对比度、读屏行为或错误恢复可用。应分别记录静态问题与实际用户流程观察。
比较构建前,固定页面范围与用户任务
写明实际任务,例如找到预约字段、修正无效值并进入下一步。浏览器审核应覆盖相关加载、空内容、错误与浮层状态。在 review-input.json 中保留稳定项目标识,列出获准的相对 HTML 页面。输入支持 1–30 个不重复页面,拒绝超过 1 MB 的来源、符号链接及路径穿越。这里使用源码目录,不会自动扫描公网网站。
修正前后使用相同的目标页面范围。将页面从输入中移除后,其旧问题进入 Removed from scope,不会变为已修复。问题对应使用唯一的自定义元素 ID 或同标签源码序号,重新排列无标识元素后应人工核对匹配。
运行双页示例,检查实际差异
在完整安装目录,将以下命令输出到新文件夹。Wayfinder 页面是虚构练习,不应用它们替换自己的源码。第二条命令将改进后的源码与第一份报告比较;向已有输出目录重新生成会被拒绝。
| 证据 | 练习预期结果 | 能证明什么 |
|---|---|---|
| 初始源码问题 | 两页共 20 项问题 | 内置规则发现了这些源码模式 |
| 当前源码问题 | 仍有 2 项问题 | 未命名 iframe 和缺少表头的表格仍需审核 |
| 比较 | 18 项解决、2 项持续、0 项新增 | 仅证明保留范围内的有限变化 |
| 实际检查类别 | 8 类均保持 not-run | 未编造浏览器或辅助技术检查结果 |
python3 scripts/build-review.py --input examples/review.json --root examples/site-before --output ./review-before
python3 scripts/build-review.py --input examples/review.json --root examples/site-after --baseline review-before/report.json --output ./review-after将每项问题追溯到其自己的源码
打开 review-after/index.html,搜索规则、筛选严重程度,并切换 Current、New、Resolved 和 Removed from scope。选择 iframe-title 问题,将页面、源码行及惰性摘录与 booking.html 对照。检查该问题自己的 SHA-256,不要假定每个面板都显示当前构建。已解决问题仍保留旧基线哈希。
优先处理受阻任务,为控件提供有用名称与原生语义,连接标签和 ARIA 引用,并结合上下文检查文档语言、标题、地标及表格关系。“存在”只是初步检查:alt 属性可能描述错误图片,空 alt 也只是装饰图片声明,需要根据上下文审核。
记录实际浏览器观察,不将所有行都填为通过
每个实际通过或失败都应填写具体记录,说明来源/构建、浏览器或工具、操作与结果。下载 manual-review.json,再以 --manual 针对完全相同的源码哈希重新生成。导入器拒绝哈希变化,以及没有说明的通过/失败。它检查记录结构和来源,不判断所述审核是否真实或完整。
- 键盘与焦点:不使用指针完成实际任务,检查焦点顺序、可见焦点、浮层进入与返回,以及适用场景的退出行为。
- 缩放与对比度:检查 200% 文字缩放、窄屏重排及实际前景/背景组合。源码属性存在与否不能测量这些结果。
- 读屏与错误:在目标应用检查名称、角色、播报、必填字段、无效值及恢复。没有使用所需工具或未执行审核时,保持 not-run。
- 动效与动态变化:检查减少动态效果偏好,以及交互后出现的对话框与更新。仅检查源码不会触发这些状态。
python3 scripts/build-review.py --input examples/review.json --root examples/site-after --baseline review-before/report.json --manual manual-review.json --output ./review-with-observations交付问题清单、范围与未完成检查
交付 report.json、findings.csv、remediation.md、审核输入、惰性 sources/*.html.txt 副本、已提供的基线及 delivery-manifest.json;实际完成过人工审核时附上记录。说明结果前检查每项剩余问题与未探索状态。静态计数不是通用无障碍评分。
用于 CI 时,--fail-on serious 或 --fail-on moderate 会先生成有效报告,再在仍有符合阈值的问题时返回退出码 2。输入错误不会创建交付。自动化应保留这个区别,不能只因文件存在就认定检查关卡通过。