SuperAPI AI 工具集

a11y

测试与质量

查看项目

更新于 10-16 05:50

技能介绍

用途:审计前端代码的无障碍(accessibility/a11y)合规性,适用于用户提出检查无障碍、执行 /a11y、审计 a11y、检查 WCAG 或定位可访问性问题的场景。

主要能力:先从 package.json 检测框架(React、Vue、Svelte);对 JSX/TSX/HTML 文件做静态分析,检查常见违规,如 <img> 缺少 alt、仅图标按钮缺少 aria-label、输入框无 <label>、非语义交互元素(如 <div onClick>、<span onClick>)、<label> 缺少 htmlFor/for、标题层级跳跃(h1 直接到 h3)、缺少地标角色(<main>、<nav>、<header>)。若开发服务器正在运行,可选执行 axe-core CLI:npx @axe-core/cli@4 http://localhost:3000。

输出与用法:结果按 WCAG 标准分组——Critical(WCAG A,阻碍辅助技术用户)、Serious(WCAG AA,显著影响可用性)、Suggestions(最佳实践改进)。每条报告包含 file:line、违规内容、对应 WCAG 标准和修复建议,并优先关注键盘导航与屏幕阅读器问题。

限制与错误处理:不会自动修复,只说明应改什么及原因。若 @axe-core/cli 因无运行中的开发服务器而失败,则仅回退到静态分析并注明跳过了 axe 扫描;若找不到 JSX/HTML 文件,则报告项目结构不兼容并停止;若无法检测框架,则扫描所有 .html、.jsx、.tsx、.vue 文件。