gsd-2 键盘导航预取(Prefetch on Keyboard Navigation):基于 Tab 焦点接近的感知式预取模式
gsd-2 键盘导航预取(Prefetch on Keyboard Navigation):基于 Tab 焦点接近的感知式预取模式
导读
键盘导航预取(Prefetch on Keyboard Navigation)是 gsd-2 仓库中 userinterface-wiki 技能包在"预测性预取(Predictive Prefetching)"分类下定义的一条 UI/UX 规则:它要求开发者监听焦点(focus)变化,当用户通过 Tab 键行进到距目标元素还剩几个焦点停靠点时,就提前触发该路由的预取。与基于鼠标悬停的预取不同,这条规则专门覆盖没有指针设备的键盘用户,让预取能力向无障碍(a11y)场景平等延伸。读完本文,你将掌握 useForesight 式焦点感知预取的完整写法、它与 hitSlop、轨迹预判、触摸回退等姊妹规则的组合方式,以及如何在实际项目中判断"该不该启用预取"。
规则定位:它在 gsd-2 的 UI 审查体系中的位置
该规则文件位于 src/resources/skills/userinterface-wiki/rules/prefetch-keyboard-tab.md,属于仓库内置的 userinterface-wiki 技能包。该技能包在 SKILL.md 中被描述为一套"面向 Web 界面的 UI/UX 最佳实践",共 152 条规则、覆盖 12 个分类,用于指导自动化的代码审查与代码生成(文档原文明确提到 "prioritized by impact to guide automated code review and generation")。
其中"预测性预取(Predictive Prefetching)"是第 10 分类,影响等级为 MEDIUM,前缀为 prefetch-,共包含 6 条规则:
| 规则文件 | 核心主题 |
|---|---|
prefetch-trajectory-over-hover |
用光标轨迹预判取代悬停预取,提前 100-200ms |
prefetch-not-everything |
按用户意图预取,而非按视口可见性预取 |
prefetch-hit-slop |
用 hitSlop 扩大不可见预判区域,更早触发 |
prefetch-touch-fallback |
触摸设备无光标时的优雅回退策略 |
prefetch-keyboard-tab |
键盘导航(Tab 焦点接近)时触发预取 |
prefetch-use-selectively |
仅在导航延迟可感知的项目中启用 |
本篇文章聚焦的 prefetch-keyboard-tab 正是其中的键盘无障碍分支:鼠标用户有 hover,触摸用户有 touch-start,而键盘用户唯一的"接近信号"就是焦点在 tab 顺序中的移动。
核心规则:在焦点接近时预取,而不是在焦点命中时
规则原文对它的定义是:
Monitor focus changes and prefetch when the user is a few tab stops away from a registered element. (监控焦点变化,当用户距离已注册元素还剩几个 Tab 停靠点时即触发预取。)
关键词是 "a few tab stops away"(还剩几个 tab 停靠点)。这意味着预取动作不应等到元素真正获得焦点(那样就太晚了,与用户按下回车几乎同时),而应在焦点逐级逼近目标的过程中提前完成网络与渲染准备。规则给出的正确写法:
const { elementRef } = useForesight({
callback: () => router.prefetch("/settings"),
name: "settings-link",
// Tab prediction fires when focus approaches
});
从这条代码示例可以读出 useForesight 钩子的核心契约:
callback:预取动作本身。在 React Router / Next.js 生态中通常是router.prefetch(path),为/settings这类路由提前拉取数据与 chunk;name:给被跟踪元素一个语义化标识(如"settings-link"),便于内部注册与焦点接近度匹配;elementRef:返回值,需要绑定到实际元素上(文档原文注释明确:Tab 预测在"焦点接近"时触发,而非聚焦后触发)。
需要说明的是:useForesight 是规则文档所展示的 API 模式(从源码检索看,仓库中并未包含 useForesight 的具体实现文件),因此在使用时应把它理解为一个约定式接口——任何实现"焦点接近度预测"的钩子都应至少提供 callback、name、elementRef 三个契约。
为什么键盘用户需要独立的预取策略
hover 预取对键盘用户是盲区
prefetch-trajectory-over-hover 规则指出,基于 onMouseEnter 的 hover 预取"开始得太晚",轨迹预判可以在光标还在运动时就触发,从而夺回 100-200ms。但无论 hover 还是轨迹预判,其前提都是"存在一个正在移动的指针设备"。键盘用户根本不产生 hover 事件——他们通过 Tab / Shift+Tab 在焦点停靠点之间移动,而这条路径同样存在可观的感知延迟:从聚焦一个链接到按下 Enter 完成导航,中间隔着键盘扫描与反应时间。
感知性能的同一套逻辑(Doherty 阈值)
userinterface-wiki 的 ux-doherty-under-400ms 与 ux-doherty-perceived-speed 两条规则强调:系统应在 400ms 内对用户操作做出响应,否则交互就会"感觉慢"。键盘导航同理——如果焦点落到某个链接上用户才按下回车、此时才开始拉取路由数据,导航的等待时间会直接暴露给用户。prefetch-keyboard-tab 正是把鼠标生态里"提前加载"的思路平移到键盘生态:在焦点接近目标(还剩几个 tab stop)时就把资源加载完成,让最终的 Enter 导航瞬间完成。
无障碍不是附属需求
该规则在 frontmatter 中标注了 a11y 标签,说明它被技能包视为无障碍议题的一部分,与 appropriate-no-high-frequency(不在打字/键盘导航时播放声音)等规则同属"键盘体验平等化"的约束。键盘预取让屏幕阅读器用户、仅键盘用户与鼠标用户获得同等的导航速度,而不是让无障碍路径成为性能劣化路径。
与姊妹规则的组合:一套完整的"意图感知预取"方案
单看 prefetch-keyboard-tab 只是冰山一角。在同目录下(src/resources/skills/userinterface-wiki/rules/)的 5 条 prefetch 规则共同构成一套完整的设备感知预取策略,可按下表组合落地:
| 设备 / 场景 | 触发信号 | 对应规则 | 关键参数 |
|---|---|---|---|
| 鼠标 | 光标轨迹逼近目标 | prefetch-trajectory-over-hover |
hitSlop: 20 |
| 鼠标 | 扩大预判热区 | prefetch-hit-slop |
hitSlop: 20(而非 0) |
| 键盘 | 焦点接近(还剩几个 tab stop) | prefetch-keyboard-tab |
name: "settings-link" |
| 触摸 | 无光标,回退到 touch-start/视口策略 | prefetch-touch-fallback |
设备感知自动切换 |
| 所有 | 按意图而非视口 | prefetch-not-everything |
prefetch={false} 交还给预测机制 |
| 项目级 | 延迟可感知才启用 | prefetch-use-selectively |
场景取舍 |
hitSlop:把"接近"变成可量化的距离
prefetch-hit-slop 规则展示了 hitSlop 参数的意义——它是围绕元素展开的不可见预判区域,值越大,触发预取所需的"接近距离"就越宽容:
// 错误:预判区域为 0,只有指针精确进入元素才会触发,太晚
const { elementRef } = useForesight({
callback: () => prefetch(),
hitSlop: 0,
});
// 正确:预判区域扩大 20px,提前启动加载
const { elementRef } = useForesight({
callback: () => prefetch(),
hitSlop: 20,
});
对于键盘预取,hitSlop 的语义可类比为"提前几个 tab stop 触发"的余量:区域越宽,预取开始得越早,但也要权衡带宽浪费(见下文 prefetch-not-everything)。
触摸设备回退:策略必须是设备感知的
prefetch-touch-fallback 规则明确指出触摸设备没有光标,应自动回退到视口(viewport)或 touch-start 策略:
// 错误:假设光标必然存在
function PrefetchLink({ href, children }) {
return (
<Link href={href} onMouseMove={() => prefetch(href)}>
{children}
</Link>
);
}
// 正确:交给设备感知的钩子,移动端自动回退到 touch-start
const { elementRef } = useForesight({
callback: () => router.prefetch(href),
hitSlop: 20,
});
// Automatically falls back to touch-start on mobile
这意味着一个完整的预取实现应具备三态路由:鼠标→轨迹预判、键盘→焦点接近预判、触摸→touch-start/视口回退,而 prefetch-keyboard-tab 是其中键盘态的实现规范。
按意图预取,而不是按视口预取
prefetch-not-everything 规则(impact: HIGH)提出了边界约束:不要因为元素"在视口内可见"就对所有链接预取,那会造成大量带宽浪费:
// 错误:视口内每个链接都无条件预取
<Link href="/page" prefetch={true}>Page</Link>
// 正确:关闭无条件预取,交给轨迹/hover/焦点预测机制按意图触发
<Link href="/page" prefetch={false}>Page</Link>
prefetch-keyboard-tab 本质上就是一种"按意图"的预取:焦点正在逼近,说明用户即将激活该元素,这是比"可见性"强得多的意图信号。两规则结合后的正确姿态是:默认关闭静态预取,用聚焦/接近事件驱动的预测机制按需触发。
选择性使用:预取不是万灵药
prefetch-use-selectively 规则给出场景取舍:
- 适用场景:数据密集型仪表盘、API 响应慢的多页应用、电商商品页(导航延迟可感知);
- 不适用的场景:静态站点(导航本就即时)、所有数据已预加载的单页应用(预取无收益)。
该规则建议在导航延迟"可感知"的地方才引入预测性预取——这与 prefetch-keyboard-tab 的目标完全一致:它服务的不是"预取更多",而是"在真正需要消除感知延迟的地方,让每一种输入方式都能平等地受益"。
落地自检清单
基于上述规则整理一份可执行的落地清单,可直接用于代码审查(这也是 userinterface-wiki 技能包在仓库中的用途——输出 file:line 级审查结论):
- 键盘路径是否覆盖:导航链接的预取是否只挂在
onMouseEnter上?若是,则为键盘用户补充焦点接近预取(prefetch-keyboard-tab); - 接近度是否可调:预取触发是否绑定到"焦点真正命中"而非"焦点接近"?是否提供了
name标识与类似 hitSlop 的提前量参数; - 是否设备感知:移动端是否会退回到 touch-start / 视口策略(
prefetch-touch-fallback); - 是否按意图触发:是否仍在使用
prefetch={true}对视口内所有链接做无条件预取(应改为prefetch={false}交给预测机制); - 是否值得启用:当前项目是静态站还是延迟敏感的多页应用(
prefetch-use-selectively)——如果导航本来就即时,整套预取机制都不应启用。
小结
prefetch-keyboard-tab 解决的是一个常被忽视的细节:键盘用户在焦点逼近目标元素时同样应该享受"提前加载"带来的即时导航。它通过与 prefetch-hit-slop(扩大预判区域)、prefetch-trajectory-over-hover(鼠标轨迹预判)、prefetch-touch-fallback(触摸回退)、prefetch-not-everything(按意图预取)等规则的组合,成为 userinterface-wiki 技能包中"预测性预取"分类的完整闭环。在 gsd-2 中,这条规则连同其余 151 条 UI/UX 规则一起,服务于自动化代码审查与生成流程,是"让界面感觉更快且对所有用户平等"这一目标在感知性能维度的具体落地。