用途:该技能面向所有包含交互式 UI 元素的项目,要求所有交互功能仅用键盘即可完整使用,不依赖鼠标或触摸(除非功能本身确实依赖路径式移动)。键盘可访问不等于按 Tab 遍历每个控件,原生控件与复合控件使用不同按键约定。
主要能力:给出严重度分级(Critical、Serious、Moderate、Minor),并强调严重度应依据对任务的实际影响判断,而非仅看规则本身。核心规则包括:不得存在键盘陷阱,焦点进入组件后必须能用 Tab、Shift+Tab、方向键或 Escape 离开;所有可用鼠标激活的元素必须可被键盘到达和激活,优先使用原生元素;遵循预期按键行为(按钮 Enter/Space、链接 Enter、复选框 Space、单选组方向键加 Space、菜单方向键加 Enter 与 Escape、标签页方向键、对话框 Escape、树视图方向键、滑块方向键与 Home/End、网格方向键等);对话框焦点管理,推荐原生 dialog 配合 showModal(),手动方案可用 inert 属性或 focus-trap 库;非模态披露与弹出层不得困住焦点;焦点可见性、焦点不被遮挡、焦点顺序、复合控件 roving tabindex、字符快捷键、跳转链接与地标、隐藏与 inert 内容、动态内容与客户端导航等。
使用方式:将规则应用于每个交互元素与功能;自定义控件应参照当前 WAI-ARIA APG 完整模式实现,而非仅照抄摘要表;测试实际结果,而不只是检查是否存在 keydown 处理器。
适用场景:按钮、链接、模态框、下拉菜单、滑块、标签页、轮播及任何自定义控件;嵌入式编辑器、第三方控件、iframe、媒体播放器、远程桌面与 canvas 应用需重点测试。
限制:资料未提供安装命令、收费、价格或平台信息;APG 模式为设计指导,本身不是 WCAG 要求,需确认当前版本;CSS 滚动间距等辅助手段不能证明合规,需在各断点、缩放、文本间距与持久覆盖层下测试。