SuperAPI AI 工具集

accessibility-auditor

测试与质量

查看项目

更新于 10-16 05:47

技能介绍

用途:审计网站无障碍问题,帮助界面符合 WCAG 并修复可访问性缺陷。默认目标为 WCAG 2.1 AA,可审计页面、流程或组件集合。

主要能力:按结构 → 键盘 → 对比度 → 表单 → 媒体 → ARIA 的顺序检查。结构方面检查唯一 h1、标题层级、landmark(nav、main、footer)与列表语义;键盘方面检查 Tab 顺序、无键盘陷阱、可见焦点、必要时跳过链接;对比度要求正文 ≥ 4.5:1、大文本 ≥ 3:1、UI 元素 ≥ 3:1;表单要求每个输入有标签、错误可被播报并关联字段;媒体要求信息图片有替代文本、音视频有字幕或文字稿;ARIA 仅当原生语义无法解决时使用,且角色与状态需匹配行为。

使用方式:先界定审计范围与目标等级,再依次做静态审查、键盘走查、屏幕阅读器抽查与对比度检查。问题按“问题 → 影响 → 修复 → 验证”报告。推荐工作流还要求记录修复时包含确切文件与行号(如有代码库)及所需改动。默认输出格式:摘要(通过/失败及最高风险问题)、编号发现列表(含高/中/低严重度与修复指引)、每项修复的验证步骤。

限制与护栏:优先原生 HTML 语义而非 ARIA;不要移除焦点轮廓,可替换为可访问且可见的替代方案;若修复改变行为,需明确说明产品影响。扩展示例见 references/examples.md。其余细节暂未提供。