DIV CSS 佈局教程網

Bootstrap 插件總覽:data API、編程式 API、命名空間與事件模型
編輯:關於JavaScript     

前面章節討論的版面元件只是起點。Bootstrap 自帶一批 jQuery 插件,把靜態版面延伸成可互動的介面。好消息是——即使你不是 JavaScript 專家,也能透過 Bootstrap Data API 在大多數情況下不寫一行程式就完成啟用。

一、兩種引入方式

單獨引入:載入個別的 *.js 檔。部分插件與 CSS 元件彼此有依賴關係(例如 Popover 依賴 Tooltip),單獨引入時必須先確認依賴順序。

整包引入:載入 bootstrap.js 或壓縮版 bootstrap.min.js。

切勿同時引入這兩個檔案——它們都包含全部插件,重複載入會造成事件被重複綁定,同一個動作觸發兩次。

所有插件都依賴 jQuery,因此 jQuery 必須排在插件之前。具體支援的 jQuery 版本可查 bower.json。

二、Data 屬性 API

僅靠 data 屬性就能使用所有 Bootstrap 插件,不需要寫任何 JavaScript。這是 Bootstrap 中的一等 API,也應該是你的首選方式。

某些情況下可能需要關閉它,方法是解除以 data-api 為命名空間、綁定在文件上的事件:

$(document).off('.data-api')

若只想關閉某個特定插件,在命名空間前加上插件名稱即可:

$(document).off('.alert.data-api')

三、編程式 API

Bootstrap 為所有插件提供了純 JavaScript 的 API。所有公開方法都支援單獨呼叫或鏈式呼叫,並回傳其操作的元素集合(與 jQuery 的慣例一致):

$(".btn.danger").button("toggle").addClass("fat")

每個方法都可以接受三種形式的參數:一個可選的選項物件、一個代表特定方法的字串、或完全不带參數(此時以預設行為初始化插件):

// 以預設行為初始化
$("#myModal").modal()

// 以自訂選項初始化
$("#myModal").modal({ keyboard: false })

// 初始化並立即呼叫 show
$("#myModal").modal('show')

每個插件都在 Constructor 屬性上暴露了原始建構函式:$.fn.popover.Constructor。若想取得某個特定插件的實例,可以直接從頁面元素讀取:

$('[rel=popover]').data('popover')

這個技巧在除錯時特別有用——你可以在 console 中直接檢查插件目前的選項與狀態,而不必猜測。

四、避免命名空間衝突

當 Bootstrap 需要與其他 UI 框架共存時,可能發生命名空間衝突(例如兩邊都定義了 $.fn.button)。此時可呼叫插件的 .noConflict 方法還原其原始值:

// 先把 $.fn.button 原本的值存起來
var bootstrapButton = $.fn.button.noConflict()
// 再把 Bootstrap 的功能掛到別的名稱上
$.fn.bootstrapBtn = bootstrapButton

五、事件模型

Bootstrap 為多數插件的關鍵行為提供了自訂事件,命名規則是「事件名 + .bs.插件名」,且一律有兩種時態:

動詞原形(現在式):在事件「開始時」觸發,例如 show。這類事件提供了 preventDefault 能力,可以在動作發生前取消它:

$('#myModal').on('show.bs.modal', function (e) {
  // 若資料不齊全,就阻止模態框顯示
  if (!data) return e.preventDefault()
})

過去分詞式:在動作「完成後」觸發,例如 shown。這類事件無法取消,適合用來做後續處理(設定焦點、發送統計、載入延遲內容)。

把這兩種時態的職責分清楚,是寫 Bootstrap 互動時最重要的一條原則:要攔截就在現在式,要收尾就在過去式。

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