SuperAPI AI 工具集

accessibility-audit

测试与质量

查看项目

更新于 10-16 01:37

技能介绍

用途:对页面、组件或 PR 做快速、高信号的可访问性初筛,默认目标为 WCAG 2.2 AA。适用场景包括发布前快速检查、组件级 a11y 验证、PR 中的可访问性回归审查、合规冒烟检查,以及新功能键盘导航验证。

主要能力与用法:先运行自动化工具,例如 npx @axe-core/cli <url>、npx pa11y <url> --standard WCAG2AA,或使用 Chrome DevTools 的 Lighthouse 可访问性评分。随后进行人工核对:所有交互元素可经 Tab 到达、焦点指示始终可见、无键盘陷阱、Tab 顺序合理、长页面跳过链接可用;语义与标签方面要求单一描述性 H1、标题层级合理、表单输入有可见标签或 aria-label、按钮与链接名称清晰、图片有有意义的替代文本(装饰性图片可为空)。对比度要求:普通文字 4.5:1,大号文字 3:1,UI 组件(输入、按钮、焦点环)3:1。动效方面需尊重 prefers-reduced-motion,动态更新用 aria-live 播报。

输出格式:按结果(通过、需修复、升级为完整审计)与发现表格(严重级别、问题、位置、修复指引)报告,必要时给出升级建议。

限制:这是冒烟检查而非完整合规审计;自动化工具只能发现约 30-40% 的问题,手动测试必不可少,完整覆盖需使用 VoiceOver、NVDA 等真实屏幕阅读器。遇到导航结构新增或变更、复杂表单或认证流程、自定义组件或高级交互(模态、手风琴、标签页)、公开发布或合规要求、页面结构重大变化、自动化扫描出现多个严重问题时,应升级为完整审计。若需其他合规级别,须明确说明。