SuperAPI AI 工具集

accessibility

测试与质量

查看项目

更新于 10-15 23:47

技能介绍

用途:为网页项目提供无障碍与可用性质量保障,尤其面向残障用户。资料强调无障碍应从一开始就纳入,后期改造代价更高;在 AI 驱动开发、人工测试有限时更需如此。

主要能力:要求使用语义化 HTML 与正确结构,如用真实 <button>、<header>/<nav>/<main>、<form> 与 <label>、逻辑标题层级;优先使用 <select>、<details>、<dialog> 等原生元素。仅在无替代方案时使用 ARIA,并记录理由。为非文本媒体提供替代文本、字幕或转录;数据表使用 <th> 与 scope。组件结构需反映语义,保持一致的焦点指示,确保所有交互元素可仅用键盘操作。遵循 WCAG 触摸目标尺寸规则,拖拽等手势需提供替代方式。

使用方式:在代码中大量添加注释,依据 WCAG 2.2 说明无障碍实现与预期用户流程。使用无障碍 linter 与库,如 React 的 eslint-plugin-JSX-a11y,优先社区验证过的无障碍组件。将 Pa11y 等自动化测试纳入回归测试。持续维护:新增媒体必须提供 alt 文本,图标加标签并对纯视觉内容用 aria-hidden="true";新增颜色或样式变更需检查对比度,普通文本至少 4.5:1,大文本至少 3:1;保持标题层级与地标结构;每次变更重新评估。

适用场景:任何网页项目,包括表单、导航、轮播、数据表、自定义组件等。

限制:资料明确该技能不构成无障碍开发所需的全部知识,不确定时应记录并仅查阅 W3C/WCAG/WAI-ARIA 官方资源。若请求可能引入无障碍缺陷,应告知用户并询问是否继续。资料未提供安装命令、价格或平台信息。