用途:这是一个纯键盘可访问性走查技能。它把鼠标放到一边,只用键盘在运行中的页面上逐步走查,记录每一次焦点停留,并给出一份带编号的报告,指出键盘无法到达、无法看见或无法操作的控件。
主要能力:
- 按键实测:焦点顺序、可达性和可操作性都通过在实际运行页面中按下的按键来判断;走查未按到的停留点标记为 Not verified,不做推断;只要有一个控件无法到达,就计为一条发现,无论该控件多小。
- 正向与反向走查:从页面顶部按 Tab 直到焦点离开页面,再用 Shift+Tab 返回起点,读取 window.__keyboard.stops 并调用 window.__keyboard.highlight()。
- 顺序检查:停留点应遵循布局的阅读顺序;从页头跳到页脚再返回、或出现任何正 tabindex,属于 keyboard-order-follows-layout。
- 可见性检查:每个停留点应在屏幕上显示指示;无可见焦点环属于 keyboard-see-every-stop;焦点落在关闭抽屉内的链接上属于 keyboard-no-hidden-stops;无名称的停留点引用 defaults-name-icon-buttons。
- 跳转链接:当导航位于主内容之前时,第一个停留点应是跳转到主内容的 Skip 链接;若首个结果之前有二十个页头停留点,属于 keyboard-skip-link。
- 可达性检查:将停留点与页面显示内容及记录器的不可达列表比较;走查从未落到的可点击 div 属于 keyboard-reach-every-control。
- 操作检查:Enter 和 Space 应按下按钮,Enter 应跟随链接,Space 应切换复选框和开关;只能响应点击而不能响应按键的控件属于 keyboard-operate-every-control。
- 复合控件:菜单、标签页、单选组、列表框和网格应只有一个 Tab 停留点,方向键在内部移动;每个菜单项各自成为 Tab 停留点属于 keyboard-arrows-inside-composites。
- 关闭浮层:Escape 应关闭打开的菜单、浮层、面板或对话框;只能点击关闭的浮层属于 keyboard-escape-closes。
- 浮层焦点:从键盘打开每个对话框、菜单和浮层,焦点应移入其中、在模态内停留并在关闭后返回触发元素;失败引用 defaults-trap-and-return-focus。
- 删除后焦点:从键盘删除一行、关闭提示、折叠区域并提交表单,焦点应落到相邻项、容器或结果上;记录器标记为丢失、焦点留在 body 上的停留点属于 keyboard-focus-survives-removal。
- 报告输出:以角色和名称的编号列表返回停留点,并附显示 highlight() 编号的截图;每条发现引用停留点编号和失败的按键;没有停留点和按键的发现属于 keyboard-numbered-walk。
使用方式:
- 加载记录器:在用户指定的状态打开页面,不点击任何东西;通过浏览器的 evaluate 调用运行 tabstops.js。它先返回没有键盘入口的指针目标,然后在按键时记录每个停留点。不得从标记推断顺序或可达性。
- 通过可信输入发送按键,例如 Playwright 的 keyboard.press 或操作系统;派发的 DOM KeyboardEvent 不会移动焦点,因此若走查没有停留点,说明按键未到达。
- 正向按 Tab 直到焦点离开页面,再 Shift+Tab 回到起点;读取 window.__keyboard.stops 并调用 window.__keyboard.highlight()。
- 将停留点与页面显示内容及记录器的不可达列表对照,确认每个控件都能到达。
- 对每个控件测试 Enter、Space 和方向键操作,并测试 Escape 关闭浮层。
- 从键盘打开并关闭每个浮层,检查焦点进入、停留和返回。
- 执行删除、关闭提示、折叠、提交等操作,检查焦点去向。
- 输出编号报告,并按规则引用停留点与按键。
适用场景:需要对运行中的网页进行纯键盘可访问性审查时,例如检查焦点顺序、焦点可见性、隐藏内容焦点、跳转链接、复合控件键盘交互、浮层焦点管理和操作后焦点保留。
限制与边界:
- 焦点环外观、对话框焦点陷阱和无障碍名称属于 defaults,其失败需引用对应 id。
- 打开运行结果属于 verify;强制打开隐藏状态属于 lab。
- 跨源 iframe 内的内容标记为 Not verified。
- 报告严重度:HIGH 为键盘无法到达或操作的控件,或操作后焦点丢失到 body;MEDIUM 为停留点不符合阅读顺序、无可见焦点环、隐藏在屏幕外、复合控件每个项各占一个 Tab 停留点、或 Escape 无法关闭的浮层;LOW 为缺少跳转链接,或报告没有编号停留点。发现按根因编号并引用停留点,格式为:file:line - [rule-id] stop N, key, what is wrong;找不到源码行时引用记录器的元素,随后给出 Rule | Count | Severity 汇总;存在任何 HIGH 则阻塞,否则批准。
价格、收费、平台和具体安装命令:资料暂未提供。