用途:对设计系统中的一个组件做结构化无障碍审计,依据 WCAG 2.2 AA(若团队法律义务要求可用 2.1 AA)。组件级审计比页面级更有效,因为修好源头可让所有使用该组件的产品同步受益。
主要能力:按五个维度评估——键盘导航(Tab 顺序、Enter/Space 激活、方向键、Escape 关闭、越过大量内容)、屏幕阅读器体验(角色、状态、可访问名称、分组标签、动态区域、说明描述)、颜色与对比度(文本 4.5:1、非文本 3:1、焦点指示器对比、不以颜色为唯一信息手段)、焦点管理(打开时的焦点位置、焦点陷阱、关闭后焦点回归、焦点可见性、焦点不被遮挡)、ARIA 实现(角色恰当性、必需属性、禁用模式、地标区域)。此外按组件类型检查目标尺寸 24×24、拖拽替代、标签名称、悬停内容、文本间距、重复输入、状态消息、错误识别、重排与缩放、强制颜色、动效等。每条标准给出 PASS/FAIL/WARN 与具体修复建议,整体状态取最差结果。
使用方式:先确认 frontmatter 中 references 路径存在,缺失说明安装不完整,需按 1-INSTALL.md 重装并运行 verify-install.sh,除非用户明确要求否则不要继续;若 .ds-ops-config.yml 存在则读取 severity.missing_aria 与 gates.accessibility.keyboard_blocks_release、contrast_blocks_release。先收集组件信息并寻找可运行证据,如 Storybook(npx test-storybook --url <storybook> 可按故事运行 axe)、jest-axe/vitest-axe、Playwright + @axe-core/playwright 或开发服务器;没有运行时证据时键盘、屏幕阅读器、焦点均为 WARN,且须在报告首行说明,只有对比度可给出 PASS/FAIL。报告包含审计日期、WCAG 级别、评估方式、各维度结果表(含证据与修复)、严重级别分级和关键发现。
适用场景与限制:一次只审计一个组件;页面级或整产品审计需升级到专门流程;未指明组件时应先询问;无实现仅有设计稿时,仅评估设计意图,键盘与屏幕阅读器结论须对照实现验证。输出不是合规报告,而是需要改动什么的实用指南。屏幕阅读器测试可使用 VoiceOver(Cmd+F5)与 NVDA。价格、许可证等信息暂未提供。