gsd-2 键盘导航预取(Prefetch on Keyboard Navigation):基于 Tab 焦点接近的感知式预取模式

原创2026-10-08 20:37:591,884 阅读
文章标签:人工智能AI Agent代码智能体CLIMCP 服务前端

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 级审查结论):

  1. 键盘路径是否覆盖:导航链接的预取是否只挂在 onMouseEnter 上?若是,则为键盘用户补充焦点接近预取(prefetch-keyboard-tab);
  2. 接近度是否可调:预取触发是否绑定到"焦点真正命中"而非"焦点接近"?是否提供了 name 标识与类似 hitSlop 的提前量参数;
  3. 是否设备感知:移动端是否会退回到 touch-start / 视口策略(prefetch-touch-fallback);
  4. 是否按意图触发:是否仍在使用 prefetch={true} 对视口内所有链接做无条件预取(应改为 prefetch={false} 交给预测机制);
  5. 是否值得启用:当前项目是静态站还是延迟敏感的多页应用(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 规则一起,服务于自动化代码审查与生成流程,是"让界面感觉更快且对所有用户平等"这一目标在感知性能维度的具体落地。

登录后查看全文
gsd-2