DIV CSS 佈局教程網

Bootstrap 滾動監聽(Scrollspy)插件詳解
編輯:關於JavaScript     

滾動監聽插件又稱「自動更新導航」,它會依據捲軸位置自動為對應的導航項目加上 .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('新條目被激活後觸發此事件!');
});

四、refresh 更新方法

滾動監聽另有一個用於更新容器 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,否則呼叫不會生效。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved