SuperAPI AI 工具集

web-accessibility

通用与其它

查看项目

更新于 10-15 16:47

技能介绍

用途:在 Web UI 新实现或既有 UI 评审时,把无障碍从「事后审计」前置到设计与实现流程中,覆盖键盘、焦点、表单、ARIA、对比度等问题,也适用于合并前的 a11y 检查请求。

主要能力:以原生 HTML 优先(如用 <button> 而非 div role="button"),按 CRITICAL、IMPORTANT、SUGGESTION 的严重程度排序处理;按表单、对话框、导航、表格、媒体、通知等 UI 模式逐项核对;针对 React/Next.js、Angular、Vue 的框架习惯给出不易破坏的修复;复查对比度、320px 回流、减少动效与仅靠颜色传达信息等问题。

使用方式:先界定页面/流程/组件、主要任务、输入方式与用户限制;优先处理语义、键盘、焦点、标签、错误识别与可访问名称等阻塞问题;再按 UI 模式核对要求并做框架安全修复;最后留下验证说明,列出已修复项、未验证的运行时风险与遗留项。参考文件包括 wcag-priority-map.md、common-ui-failures.md、framework-patterns.md、review-checklist.md。

适用场景:Web UI 实现与评审、键盘/焦点/表单/ARIA/对比度问题修复、对话框与导航等行为复查、框架相关 a11y 回归检查。

限制:不适用于非 Web UI 的扩展宿主或 CLI 改动、仅 Markdown 文档的无障碍改进;若需在真实浏览器中收集运行时证据(焦点陷阱、路由播报、悬停/焦点弹层等),应改用运行时验证类工具。完成标准包括仅用键盘可操作主要流程、焦点可见且能从关闭的对话框/浮层正确返回、交互元素具备可访问名称/角色/状态、表单标签与错误状态关联、无对比度/回流/仅颜色/动效遗漏,并明确未验证的运行时行为。