Bootstrap 5 滚动监听

滚动监听

滚动监听(Scrollspy)插件,即自动更新导航插件,会根据滚动条的位置自动更新对应的导航目标。其基本的实现是随着您的滚动。


如何创建滚动监听

以下实例演示了如何创建滚动监听:

实例

<!-- 可滚动区域 -->
<body data-bs-spy="scroll" data-bs-target=".navbar" data-bs-offset="50">

<!-- 导航栏 - <a> 元素用于跳转到可滚动区域中的某个部分 -->
<nav class="navbar navbar-expand-sm bg-dark navbar-dark fixed-top">
...
  <ul class="navbar-nav">
    <li><a href="#section1">第 1 节</a></li>
    ...
</nav>

<!-- 第 1 节 -->
<div id="section1">
  <h1>Section 1</h1>
  <p>尝试滚动此页面并在滚动时查看导航栏!</p>
</div>
...

</body>
亲自试一试 »

实例解析

向您想要监听的元素(通常是 <body>)添加 data-bs-spy="scroll"

然后添加 data-bs-target 属性,它的值为导航栏的 id 或 class (.navbar)。这样就可以联系上可滚动区域。

注意可滚动项元素上的 id(<div id="section1"> 必须匹配导航栏上的链接选项 <a href="#section1">)。

可选项 data-bs-offset 属性用于计算滚动位置时,距离顶部的偏移像素。 默认为 10 px。

设置相对定位: 使用 data-bs-spy="scroll" 的元素需要将其 CSS position 属性设置为 "relative" 才能起作用。