目录可用 target-current 原生跟随当前章节

  • 目录
  • Scrollspy
实现
CSS
来源
x.com
收录日期
状态
规约中
目录可用 target-current 原生跟随当前章节 规则实证样本

目录可用 target-current 原生跟随当前章节

要解决的问题

长文档通常需要目录持续指出当前章节。传统 Scrollspy 要监听滚动、计算章节边界并同步类名,容易和嵌套滚动、锚点跳转及 sticky 标题产生重复逻辑。原帖演示用滚动目标组和 :target-current 把当前项匹配交给浏览器。

规则和其他情况说明

  • 核心规则:目录中的链接指向真实章节锚点,在目录容器上设置 scroll-target-group: auto,再用 :target-current 为当前章节链接设置样式。
  • HTML 先成立:目录必须是真实链接,章节必须有对应 ID;CSS 只表达状态,不负责生成目录或修复错误的文档结构。
  • 当前态不能只靠细微颜色:演示使用黑底白字,使当前项与普通项明显区分;实际项目也可用背景、文字和标记共同表达。
  • 保留普通导航作为回退:不支持该能力时,目录仍应能跳转章节,只是可能缺少自动当前态。
  • 不把视觉当前态等同于无障碍当前态:是否需要以及如何设置 aria-current 要单独验证,不能假定伪类会自动完成所有语义同步。

结构与样式分工

<nav class="toc" aria-label="本页目录">
  <a href="#install">Install</a>
  <a href="#configure">Configure</a>
</nav>

<section id="install">…</section>
<section id="configure">…</section>
.toc {
  scroll-target-group: auto;
}

.toc a:target-current {
  background: black;
  color: white;
}
  • .toc 负责建立目录链接与滚动目标之间的关系。
  • href="#id" 与章节 ID 负责真实导航。
  • :target-current 只负责当前项表现,不应包含改变布局尺寸的样式,避免滚动时目录反复抖动。

设计时的边界判断

  • 章节边界:长章节与短章节交替时,当前项切换是否符合阅读感知,要用真实内容检查。
  • sticky 标题:滚动定位需要考虑遮挡;这与目录当前态相关,但不是 scroll-target-group 自动解决的布局问题。
  • 嵌套滚动容器:侧栏和正文分别滚动时,要确认目标组作用于预期容器。
  • 首尾位置:页面顶部尚未进入第一章、底部最后一章内容不足一屏时,当前项需要实测。
  • 点击与滚动:点击目录后的跳转、浏览器前进后退和直接打开带 hash 的 URL,都应保持可理解的状态。

关键截图与效果

Sanyam-scrollspy当前章节-X源视频帧-20261026.jpg

  • 来源:作者发布的无 JavaScript Scrollspy CSS 演示。
  • 页面或任务场景:长文档在 Install、Configure、Build、Deploy 章节间滚动,左侧为未启用对照,右侧启用 scroll-target-group: auto。
  • 具体观察:右侧当前目录项以黑底白字标记,左侧目录保持普通文本;画面同时显示 scrollTop,帮助区分滚动位置变化(E1)。
  • 支持的结论:阅读位置可以同时由正文和目录表达,当前项视觉状态不必完全依赖脚本维护。
  • 证据限制:演示证明该浏览器环境中的效果,不提供兼容矩阵,也不证明复杂真实文档中的章节判断总符合预期。

适用场景

  • 文档、帮助中心和长篇文章的页内目录。
  • 目录项与章节锚点一一对应,且当前态只需表达一个主要阅读位置。
  • 目标浏览器已经验证支持,或项目可接受无自动当前态的渐进增强回退。

不适用场景

  • 一个目录项对应多个不连续区域,或当前项需要复杂业务规则决定时,简单锚点模型可能不足。
  • 必须支持未验证浏览器且当前态是核心导航功能时,需要保留经过测试的 JavaScript 方案。
  • 不应为使用新属性而重写已经稳定、可访问且覆盖复杂场景的 Scrollspy。

复核清单

  • 目录链接与章节 ID 是否完整对应,无脚本时能否正常跳转。
  • 滚动、点击、hash 直达、前进后退是否产生一致结果。
  • 页面顶部、底部、短章节和嵌套滚动容器的当前项是否合理。
  • 当前态是否不引发布局抖动,键盘焦点与 aria-current 是否单独验证。
  • 不支持环境中是否仍保留完整目录和可读内容。

来源与证据边界