目录可用 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,都应保持可理解的状态。
关键截图与效果

- 来源:作者发布的无 JavaScript Scrollspy CSS 演示。
- 页面或任务场景:长文档在 Install、Configure、Build、Deploy 章节间滚动,左侧为未启用对照,右侧启用
scroll-target-group: auto。 - 具体观察:右侧当前目录项以黑底白字标记,左侧目录保持普通文本;画面同时显示
scrollTop,帮助区分滚动位置变化(E1)。 - 支持的结论:阅读位置可以同时由正文和目录表达,当前项视觉状态不必完全依赖脚本维护。
- 证据限制:演示证明该浏览器环境中的效果,不提供兼容矩阵,也不证明复杂真实文档中的章节判断总符合预期。
适用场景
- 文档、帮助中心和长篇文章的页内目录。
- 目录项与章节锚点一一对应,且当前态只需表达一个主要阅读位置。
- 目标浏览器已经验证支持,或项目可接受无自动当前态的渐进增强回退。
不适用场景
- 一个目录项对应多个不连续区域,或当前项需要复杂业务规则决定时,简单锚点模型可能不足。
- 必须支持未验证浏览器且当前态是核心导航功能时,需要保留经过测试的 JavaScript 方案。
- 不应为使用新属性而重写已经稳定、可访问且覆盖复杂场景的 Scrollspy。
复核清单
- 目录链接与章节 ID 是否完整对应,无脚本时能否正常跳转。
- 滚动、点击、hash 直达、前进后退是否产生一致结果。
- 页面顶部、底部、短章节和嵌套滚动容器的当前项是否合理。
- 当前态是否不引发布局抖动,键盘焦点与
aria-current是否单独验证。 - 不支持环境中是否仍保留完整目录和可读内容。
来源与证据边界
- 原帖:https://x.com/sanyampunia/status/2114348757076889996
- 本次未查阅外部兼容规范,也未在真实项目中验证键盘导航、无障碍播报和浏览器支持范围,状态保持
draft。