返回资讯中心
外部精选
软件工程
#开发者实时流

Tab Trail 书签工具可绘制页面 Tab 键顺序并标出 WCAG 不合规处

来源标题:Show HN: Tab Trail, a bookmarklet that draws a page's tab order and finds gaps

开发者发布书签工具 Tab Trail,一键绘制页面 Tab 键焦点顺序,并用红框标出不符合 WCAG 2.2 AA 的焦点遗漏点。该工具旨在帮网站检查键盘用户能否正常访问按钮和表单,因为 Lighthouse 也建议人工核查这一项。使用时将按钮拖到书签栏,打开网站点击并在页面按 Tab 或 Play 即可查看。

Hacker News 最新matjazkorosec2026/11/4 · 13 天前14 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

点一下就能显示 Tab 键在任何页面上的移动路径,并用红色标出不符合 WCAG 2.2 AA 的地方。

Tab trail v1.0.0

点它,在这里试一试。

把它拖到书签栏,就能在任何网站上使用。在手机上?点它,然后按 Play 看它走一遍这个页面。想在自己的网站上用,请在电脑上打开这个页面。

点上面的 Tab trail,看着这 3 个变成红色。

这个网站上的其他内容都通过:其他任何页面都是 0 个问题。

有些人只用键盘。如果 Tab 跳过了你的“加入购物车”按钮,他们就没办法从你这里购买。如果它跳过了联系表单上的“发送”,他们就没办法给你写信。

连 Lighthouse 都让你手动检查这一点。Tab trail 帮你检查。这是 WCAG 2.2 AA 的一部分。

1 把 Tab trail 按钮拖到你的书签栏。

2 打开你的网站,点击这个书签。

3 按 Tab,或者按 Play。

4 有新版本?再拖一次按钮。

复制书签 复制脚本

01 播放。没有 Tab 键?按 Play,它会走过每一个停留点。看一看

02 日志。查看每一项检查,通过的也能看到。看一看

每个按键、如何看懂计数、以及它何时会有意保持安静:按键。

它用红色列出的内容

03 漏掉的点。“有 2 个看起来可点击,但 Tab 跳过了它们。”红框会标出它们。WCAG 2.1.1 A 看一看

04 悬停菜单。“有 1 个菜单或框只在鼠标悬停时打开。”WCAG 2.1.1 A、2.4.7 AA 看一看

05 强制顺序。“有 1 个停留点的 tabindex 大于 0,把它拉到了页面前面。”WCAG 2.4.3 A 看一看

06 隐藏焦点。“有 1 个停留点在 Tab 到达时是隐藏的。”在吸顶栏下面。WCAG 2.4.11 AA 看一看

07 键盘陷阱。“有 1 个停留点让 Tab 卡住了。”WCAG 2.1.2 A 看一看

08 焦点丢失。“有 1 个弹窗关闭时丢失了焦点。”WCAG 2.4.3 A 看一看

09 顺序错乱。“Tab 有 1 次跳出了顺序。”WCAG 2.4.3 A 看一看

4 交给你的 AI。

你的 AI 会拿到选择器、HTML 和修复方案,在你的开发服务器上还能拿到组件。你的测试无需点击就能运行它。查看代码

10 复制给 AI。把问题粘贴到你的 AI 里。它就能拿到修复方案。看一看

复制给 AI 只复制问题,每个问题都带有它的 WCAG 规则、应当发生什么、一个 CSS 选择器、HTML、绘制它的 React、Vue 或 Angular 组件(在开发构建上)、一条修复提示,以及如何验证修复。把它粘贴到你的编码 AI 里,它就知道该去哪里找。

它打开期间,页面会有 window.__tabTrail,所以你的测试和 AI agent 无需点击就能运行它。从 npm 获取:

npm i -D --save-exact tab-trail

每个调用及其返回内容:API 参考。

一个在任何问题上都会失败的 Playwright 测试:Playwright 示例。

值得了解

停留点 5 到 8,如果你想了解更多。

如何看懂轨迹

11 Tab 顺序。数字显示 Tab 的去向。橙色的那个是你当前所在的位置。看一看

12 隐藏链接。跳转链接显示为虚线点。看一看

13 对话框内部。对话框打开了?轨迹也会进去。看一看

14 迟到者。滚动一下,新出现的按钮会被计入。看一看

15 大页面。超过 50 个停留点?一次看 50 个。看一看

如何配合使用

16 不挡路。把面板拖到任何地方,或者把它送到角落。看一看

17 计数。修复它,再运行一次,对比一下。看一看

18 找到它。点击列表中的红点就能看到它。看一看

19 键盘。没有鼠标?Ctrl+Shift+F 跳进面板。看一看

20 跳过去。点击一个数字,焦点就会移到那里。看一看

设置

21 聚光灯。让页面变暗,照亮 Tab 所在的位置。看一看

22 显示连线。只要数字?取消勾选“显示连线”。看一看

23 长连线。连线太多?取消勾选“长连线”。看一看

24 排除在 Tab 之外。面板不会出现在轨迹里。看一看

6 卡住了?

Mac 上的链接、被屏蔽的书签、Firefox。6 个回答

在 Mac 上 Tab 会跳过所有链接?Safari 会跳过链接和按钮,Firefox 会跳过链接,直到你打开它。Safari:设置、高级、“按下 Tab 键高亮显示每个项目”。Firefox:系统设置、键盘、“键盘导航”。在此之前,Tab trail 会把这些按键标记为 SKIPPED,而不是红色。

没有书签栏?按 Ctrl+Shift+B,或者在 Mac 上按 Cmd+Shift+B。

没有鼠标?在步骤 1 中按“复制书签”,给任意页面添加书签(Ctrl+D,或者在 Mac 上按 Cmd+D),然后编辑该书签,把脚本粘贴为它的地址。

我点击书签时什么都没发生?有些网站会屏蔽来自书签的脚本。改为在那里粘贴到控制台(见下一个回答)。

如何粘贴到控制台?在本页面的步骤 1 中按“复制脚本”。在你的网站上按 F12,或者在 Mac 上按 Cmd+Option+I(在 Safari 中按 Cmd+Option+C),打开 Console 并粘贴。如果它询问,输入 allow pasting,按 Enter,再粘贴一次。在 Safari 中,先在设置、高级中勾选“显示 Web 开发者功能”。

使用 Firefox?Firefox 无法把它保存为书签:那里的书签最多只能有 65,536 个字符,而 Tab trail 书签是 223,286 个字符。改为粘贴到控制台。

7 困难的部分。

它如何在你访问的任何网站上都不挡路。工作原理

它在自己的 shadow root 内绘制,所以你的 CSS 无法破坏它,而且在屏蔽添加样式的网站上它仍然有效。

它在有严格 Content Security Policy 和 Trusted Types 的页面上运行,读取开放的 shadow root,并在单页应用切换路由时再次检查。

它读取你的样式表来查找悬停规则,包括嵌套 CSS 和 Tailwind,以找出只有鼠标才能打开的菜单。

它会找到绘制每个元素的 React、Vue 或 Angular 组件,并跳过框架自身的部分。

对话框打开时,它会移进去,从而保持在顶层并且可点击。

每次发布前,我都会在 Chromium 和 WebKit 中用 Playwright 运行它,覆盖整个网站以及专门构造来让它出错的页面。

8 一个文件,在 GitHub 上。

它只读取页面,不发送任何内容。在 MIT License 下免费。有什么

在 GitHub 上看

Tab 只是 1 项测试。完整审计会检查 WCAG 2.2 AA 的其余部分。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →