滾動監聽(Scrollspy)的效果是:頁面滾動時,導航列中對應的項目會自動切換為啟用狀態。單頁網站的章節導航幾乎都會用到它。
需要三個 data 屬性:data-spy="scroll" 指定監聽行為,data-target 指向導航容器的 id,data-offset 設定偏移量(避免標題貼頂時提前或延後切換)。
<!-- 導航容器:id="menu" 即 data-target 的監聽對象 -->
<div id="menu" class="navbar navbar-fixed-top">
<div class="navbar-inner">
<ul class="nav">
<li><a href="#1">列表1</a></li>
<li><a href="#2">列表2</a></li>
<li class="dropdown">
<a href="#" data-toggle="dropdown">下拉菜單<b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a href="#3">列表3</a></li>
<li><a href="#4">列表4</a></li>
</ul>
</li>
</ul>
</div>
</div>
<!-- 被監聽的內容區 -->
<div class="scrollspy" data-spy="scroll" data-target="#menu" data-offset="30">
<h3 id="1">列表1</h3><p><img src="img/1.jpg"></p>
<h3 id="2">列表2</h3><p><img src="img/2.jpg"></p>
<h3 id="3">列表3</h3><p><img src="img/3.jpg"></p>
<h3 id="4">列表4</h3><p><img src="img/4.jpg"></p>
</div>
也可以把 data 屬性直接掛在 body 上,讓整個頁面都受監聽:
<body data-spy="scroll" data-target="#navbar" data-offset="0">
<div id="navbar">
<ul class="nav nav-pills nav-stacked">
<li><a href="#1">列表1</a></li>
<li><a href="#2">列表2</a></li>
</ul>
</div>
<div class="scrollspy">
<h3 id="1">列表1</h3><p><img src="img/1.jpg"></p>
<h3 id="2">列表2</h3><p><img src="img/2.jpg"></p>
</div>
#navbar {
position: fixed;
right: 10px;
top: 50px;
width: 200px;
background-color: #fff;
}
第一種:使用 data 屬性聲明式啟用,即上面的寫法。
第二種:用 JS 呼叫(此時 HTML 中可去掉 data-spy="scroll")。
$(function () {
$("body").scrollspy();
// 每當有新的導航項目被啟用時觸發
$("body").on("activate", function (e) {
if (e.target && $(e.target).hasClass("dropdown")) {
$(e.target).children("ul.dropdown-menu").css("display", "block");
} else {
$(e.target).parent().find("ul.dropdown-menu").css("display", "none");
}
});
});
實務上最常遇到的兩個問題:一是被監聽的容器必須真的有高度可滾動或頁面整體足夠長,否則永遠不會觸發;二是固定定位的導航條會遮住章節標題,需要為各章節加上 scroll-margin-top 或 padding-top 補償導航條高度,data-offset 也要同步調整。
另外,activate 事件搭配下拉菜單的寫法很實用——它讓「目前所在章節屬於哪個下拉分組」時,該分組自動展開,使用者不必手動點開才知道位置。