用途
本技能面向 Web 无障碍实现与审计,帮助开发者在组件与页面中落实 WCAG 2.2 标准、ARIA 创作实践、键盘交互模式与屏幕阅读器测试要求。适用于需要让组件或页面达到 a11y 合规、为自定义控件添加 ARIA 角色/状态/属性、实现键盘导航、处理屏幕阅读器播报与实时区域、执行 WCAG 2.2 审计、管理模态框与 SPA 焦点、检查色彩对比度/替代文本/语义化 HTML/表单标签,以及构建对话框、选项卡、组合框、菜单、工具提示等自定义组件时使用。纯后端代码或无 DOM 交互的 CSS 样式问题不在触发范围内。
主要能力
- 语义化 HTML 优先:提供页面结构、跳转链接、替代文本、表单标签等常见模式的可访问写法,强调原生元素自带键盘支持、焦点与屏幕阅读器播报。
- ARIA 规范与五条规则:说明角色、状态、属性的分类与用法,明确无原生元素可用时才使用 ARIA,且交互式 ARIA 控件必须支持键盘操作、不得对可聚焦元素使用 aria-hidden、所有交互元素须有可访问名称。
- 键盘导航模式:给出工具栏/选项卡列表的 roving tabindex 实现示例,包括方向键、Home、End 键处理与焦点切换代码。
- 焦点管理模型:说明 DOM 顺序即 Tab 顺序、tabindex 取值含义、复合组件 roving tabindex、模态框焦点陷阱与关闭后焦点返回,并提供 SPA 路由切换时更新标题、移动焦点与实时区域播报的代码。
- 色彩对比度要求:列出普通文本 4.5:1、大文本 3:1、UI 组件 3:1、焦点指示器 3:1 的最低比值,并强调不得仅靠颜色传达信息。
- 替代文本与标签:区分信息性图片、装饰性图片、功能性图片与复杂图片的替代文本写法,展示表单标签、提示与错误信息的关联方式。
- 自动化审计:提供 Lighthouse CLI、axe CLI、jest-axe 与 axe-core 独立审计的命令和代码示例,并附手动审计清单,包括 Tab 遍历、Enter/Space 激活、模态框焦点陷阱与返回、400% 缩放、VoiceOver/NVDA 播报质量检查。
- 反模式与注意事项:列出用 div 模拟按钮、仅用占位符作标签、使用 tabindex 正数、缺少焦点指示器、用 emoji 作功能图标等反模式及正确做法;提醒可聚焦元素上的 aria-hidden 会造成键盘陷阱、实时区域须先于内容注入、模态框关闭后焦点不会自动返回、自动化工具仅覆盖约 30% 的违规。
使用方式
该技能在对话中首次激活时会检查已安装的配套技能,并针对缺失项提示安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。当任务需要更深细节时,可加载 references/aria-patterns.md(组合框、菜单、树、列表框、手风琴、工具提示等完整 ARIA 组件模式)与 references/widget-examples.md(对话框与选项卡的焦点陷阱及 roving tabindex 实现)。
适用场景
适用于前端组件库开发、单页应用路由可访问性、模态框与浮层焦点管理、表单与图表替代文本编写、自定义控件键盘交互实现,以及发布前的 WCAG 2.2 AA 合规审计。
限制
资料明确说明自动化工具仅能发现约 30% 的 WCAG 失败项,焦点管理正确性、播报质量、阅读顺序与认知负荷仍需手动测试。该技能不适用于无 HTML 输出的纯后端代码,也不适用于无无障碍影响的纯 CSS 样式问题。其他关于具体收费、平台支持或效果数据暂未提供。