滾動監聽插件又稱「自動更新導航」,它會依據捲軸位置自動為對應的導航項目加上 .active,讓使用者知道目前讀到哪一節。
若要單獨使用這項功能,需引入 scrollspy.js;也可以直接載入 bootstrap.js 或壓縮版 bootstrap.min.js 一次取得全部插件。
1. 透過 data 屬性
在要監聽的元素(通常是 body)上加上 data-spy="scroll",再用 data-target 指向帶有 Bootstrap .nav 元件的父元素 id 或 class。要能正常運作,前提是頁面中必須存在與導航連結錨點對應的元素 id。
<body data-spy="scroll" data-target=".navbar-example"> ... <div class="navbar-example"> <ul class="nav nav-tabs"> ... </ul> </div> ... </body>
2. 透過 JavaScript
選取要監聽的元素後呼叫 .scrollspy():
$('body').scrollspy({ target: '.navbar-example' })
滾動監聽的效果是:隨著捲動,導航項目自動高亮對應章節。
// 基本實例 <nav id="nav" class="navbar navbar-default"> <a href="#" class="navbar-brand">Web 開發</a> <ul class="nav navbar-nav"> <li> <a href="#html5">HTML5</a> </li> <li> <a href="#bootstrap">Bootstrap</a> </li> <li class="dropdown"> <a href="#" data-toggle="dropdown">JavaScript <span class="caret"></span></a> <ul class="dropdown-menu"> <li><a href="#jquery">jQuery</a></li> <li><a href="#yui">Yui</a></li> <li><a href="#extjs">Extjs</a></li> </ul> </li> </ul> </nav> <div data-offset="0" data-target="#nav" data-spy="scroll" style="height: 200px; overflow: auto; position: relative; padding: 0 10px;"> <h4 id="html5">HTML5</h4> <p>標准通用標記語言下的一個應用。HTML 標準自 1999 年 12 月發布的 HTML4.01 後 曾一度停滯,為了推動 Web 標準化發展,多家公司聯合成立 WHATWG(Web 超文本應用技術工作組), 致力於 Web 表單與應用程序;W3C 則專注 XHTML2.0。2006 年雙方決定合作,共同創建新的 HTML 版本。</p> <h4 id="bootstrap">Bootstrap</h4> <p>Bootstrap 來自 Twitter,是目前很受歡迎的前端框架,基於 HTML、CSS、JAVASCRIPT, 簡潔靈活,使 Web 開發更加快捷。它由 Twitter 設計師 Mark Otto 與 Jacob Thornton 合作開發, 是一套 CSS/HTML 框架,以動態 CSS 語言 Less 寫成,長年是 GitHub 上的熱門開源專案。</p> <h4 id="jquery">jQuery</h4> <p>jQuery 是繼 prototype 之後另一個優秀的 JavaScript 庫,輕量級,相容 CSS3 與多數瀏覽器。 它讓處理 HTML、事件、動畫與 AJAX 互動都更為方便,文件完整、成熟插件眾多, 並能讓 HTML 頁面保持結構與行為分離——不必在 html 裡插入大量 js,只需定義 id 即可。</p> <h4 id="yui">Yui</h4> <p>近幾年隨著 jQuery、Ext 與 CSS3 的發展,以 Bootstrap 為代表的前端框架如雨後春筍般湧現, 桌面與行動端都有大量優秀選擇,極大豐富了開發素材。這些框架各有特點,本文做初步介紹與比較, 希望能為選擇框架提供一點幫助。</p> <h4 id="extjs">Extjs</h4> <p>ExtJS 可用來開發 RIA(富客戶端 AJAX 應用),以 JavaScript 撰寫,主要用於建立前端使用者介面, 與後台技術無關,因此可搭配 .Net、Java、Php 等各種語言的專案。ExtJs 最初基於 YUI 技術, 由 Jack Slocum 開發,參考 Java Swing 等機制組織可視化元件,從 UI 樣式到資料解析的異常處理 都可算是一款難得的 JavaScript 客戶端技術精品。</p> </div>
這裡有兩個關鍵屬性:data-spy="scroll" 宣告監聽行為,data-target 指向導航容器。

實務提醒:只有一個導航且容器明確時,不設 data-target 也能穩定運作;但一旦有多個導航,未明確關聯就容易出錯,所以建議一律加上。
改用腳本定義屬性
若使用 JavaScript 方式,可以去掉 data-*,直接在選項中指定 offset、target:
// 使用腳本方式定義屬性
$('#content').scrollspy({
offset: 0,
target: '#nav'
});
當某個導航項目被切換為啟用狀態時,會觸發 activate.bs.scrollspy 事件,事件綁定在導航元素上:

// 事件綁定在導航上
$('#nav').on('activate.bs.scrollspy', function () {
alert('新條目被激活後觸發此事件!');
});
滾動監聽另有一個用於更新容器 DOM 的方法,在動態增刪被監聽的內容後必須呼叫,否則定位會錯亂。

// HTML 部分 <section class="sec"> <h4 id="html5">HTML5 <a href="#" onclick="removeSec(this)">刪除此項</a></h4> <p> ... </p> </section>
// 刪除內容時刷新 DOM,避免導航監聽錯位
function removeSec(e) {
$(e).parents('.sec').remove();
$('#content').scrollspy('refresh');
}
最後一個容易忽略的細節:refresh 這個方法只能搭配 data-* 的宣告式用法,也就是元素上必須有 data-spy="scroll" 與 data-target,否則呼叫不會生效。