SuperAPI AI 工具集

a11y-audit

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:对指定组件或文件夹进行 WCAG AA 无障碍合规审计,同时检查组件实现与文档示例。若未提供参数,需先向用户询问组件路径或文件夹。

主要能力:按七类清单逐项核查。语义 HTML:交互元素使用原生 button、a、input,列表使用 ul/ol/li,标题层级正确,表格使用 table、thead、tbody、th 并带 scope。ARIA:自定义交互组件设置合适 role,无可见文本时用 aria-label 或 aria-labelledby,可展开触发器用 aria-expanded,可选项用 aria-selected,aria-disabled 与 disabled 同步,弹出菜单用 aria-haspopup,动态内容用 aria-live,避免冗余 ARIA。键盘导航:所有交互元素可 Tab 到达,Tab 顺序符合视觉逻辑,复合组件用方向键,Enter/Space 激活,Escape 关闭弹层,模态内焦点陷阱,关闭后焦点返回触发元素,无键盘陷阱。焦点管理:可见焦点指示,动态内容焦点转移,tabindex 使用得当,不使用正 tabindex。颜色对比:正文 4.5:1、大文本 3:1,焦点指示 3:1,信息不单靠颜色传达。屏幕阅读器:图片 alt 恰当,表单有 label,错误用 aria-describedby 关联,状态变化用 aria-live 或 role=status,装饰元素 aria-hidden。文档示例:可键盘导航,必要时加 tabindex,展示无障碍用法。

使用方式:以组件路径或文件夹作为参数调用该技能,技能会按上述清单审计并输出报告。

输出格式:标题为 A11y Audit: [组件名],给出 PASS/PARTIAL/FAIL 合规结论,并按 Critical(WCAG A 必须修复)、Major(WCAG AA 应修复)、Minor(最佳实践)分级列出 file:line 与问题描述及对应 WCAG 条款,最后附改进建议。

适用场景:组件库开发、前端代码审查、无障碍合规检查。

限制:资料未提供具体安装命令、运行环境、依赖版本、收费方式及自动化集成细节,暂未提供。