SuperAPI AI 工具集

accessibility-audit

测试与质量

查看项目

更新于 10-16 00:04

技能介绍

用途:在发布前、组件级验证、PR回归检查、新功能键盘导航验证等场景做快速无障碍分诊。

主要能力与检查项:

  • 自动化快照:可用 npx @axe-core/cli <url>、npx pa11y <url> --standard WCAG2AA 或 Chrome DevTools Lighthouse 的无障碍评分。
  • 键盘基础:所有交互元素可 Tab 到达、焦点指示可见、无键盘陷阱、Tab 顺序合理、长页面跳过链接可用。
  • 语义与标签:唯一且描述性的 H1、标题层级合理、表单输入有可见标签或 aria-label、按钮与链接名称清晰、图片有有意义 alt(装饰性可留空)。
  • 视觉对比度:普通文本 4.5:1,大文本(18pt+ 或 14pt 粗体+)3:1,UI 组件(输入框、按钮、焦点环)3:1。
  • 动效与更新:尊重 prefers-reduced-motion、动态更新用 aria-live 播报。

输出格式:按组件或页面名、结果(通过/需修复/建议升级完整审计)、问题表(严重度、问题、位置、修复建议)以及升级建议来报告。

限制与升级条件:自动化工具只能发现约30%至40%的问题,需配合真实屏幕阅读器(VoiceOver、NVDA)手动测试。遇到新增或变更的导航结构、复杂表单或认证流程、自定义控件或高级交互(模态框、手风琴、标签页)、公开发布或合规要求、页面结构重大变化、自动化扫描出现多个严重问题时,应升级为完整审计。默认目标为 WCAG 2.2 AA,如需其他合规等级需明确说明。