SuperAPI AI 工具集

web-accessibility-audit

通用与其它

查看项目

更新于 10-15 22:34

技能介绍

用途:对 Web 应用进行 WCAG 2.0/2.1/2.2 无障碍合规审计,识别常见违规并提供可执行的修复步骤。适用于用户要求无障碍审计、a11y 检查、WCAG 合规审查,或提到屏幕阅读器、键盘导航、残障用户可访问性等场景。

主要能力:围绕 POUR 四原则(可感知、可操作、可理解、健壮)与 A/AA/AAA 合规等级展开,重点覆盖 12 类常见违规,如颜色对比度不足、缺失或不当 alt 文本、缺少名称/角色/值、键盘导航失败、表单控件无标签、缺少语言属性、标题结构不当、链接文本无意义、焦点指示缺失、ARIA 滥用、数据表格标记不足、媒体缺少字幕。

使用方式:分四阶段。自动化测试可运行 ESLint(如 npx eslint --ext .jsx,.tsx --no-ignore --format json .)与 Lighthouse(npx lighthouse https://example.com --only-categories=accessibility --output=json --output-path=./lighthouse-results.json),并检查 axe-core 集成;随后用 grep 模式做人工代码检查;再按严重程度(Critical/Serious/Moderate)分组排序;最后进行键盘、屏幕阅读器(VoiceOver、NVDA、JAWS)、缩放重排、高对比度与减少动效等手动测试。输出为结构化审计报告,含摘要、问题分级、位置、问题描述与修复示例。

限制:自动化工具仅能发现约 30%–57% 的问题,必须配合手动测试;使用 ARIA 的页面平均错误更多;应优先处理键盘、屏幕阅读器与对比度等关键问题,并尽量用真实辅助技术验证。具体安装命令、脚本路径与参考文档以实际项目为准,资料未提供完整环境要求。