
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 即可查看。
以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。