SuperAPI AI 工具集

a11y

测试与质量

查看项目

更新于 10-15 20:34

技能介绍

用途:a11y 是一个面向 Web 应用的无障碍审计技能,目标是逐屏发现并修复无障碍问题。它结合 axe-core 的程序化扫描与 Playwright 的键盘遍历,覆盖从 critical 到 minor 的违规等级。

主要能力:用 axe-core 扫描每个页面,规则标签包括 wcag2a、wcag2aa、wcag21a、wcag21aa、best-practice;检测键盘导航,检查首个 Tab 是否为跳转链接、交互元素是否有可见焦点环、是否有可访问名称、触控目标是否至少 44×44px;还用 grep 做代码级结构检查,例如缺少 alt 的图片、无名称按钮、在非交互元素上使用 onClick、表单标签缺失、标题层级、html 的 lang 属性、仅用颜色表示状态,以及动态内容缺少 aria-live 等,并检查 prefers-reduced-motion。

使用方式:需先启动开发服务器(如 http://localhost:3000),并安装 axe-core 作为开发依赖,例如 pnpm add -D axe-core、npm install -D axe-core 或 yarn add -D axe-core。脚本写入项目根目录,扫描脚本 _a11y_scan.mjs 可用 node _a11y_scan.mjs --url http://localhost:3000 --name home 运行,键盘脚本 _a11y_keyboard.mjs 用法类似。受保护页面可通过 --auth 传入存储状态,并用环境变量 TEST_EMAIL、TEST_PASSWORD 等生成登录态。

适用场景:适合在交付前对全应用做逐屏无障碍审计,按“入口/高流量、收入关键、键盘受损”等因素排序修复优先级,再进入递归修复循环。

限制:资料未说明价格、平台覆盖面或最终效果保证;脚本依赖本地运行环境和 node_modules,扫描结果仍需人工判读,动画、动态内容等部分需人工复核。