前面章節討論的版面元件只是起點。Bootstrap 自帶一批 jQuery 插件,把靜態版面延伸成可互動的介面。好消息是——即使你不是 JavaScript 專家,也能透過 Bootstrap Data API 在大多數情況下不寫一行程式就完成啟用。
單獨引入:載入個別的 *.js 檔。部分插件與 CSS 元件彼此有依賴關係(例如 Popover 依賴 Tooltip),單獨引入時必須先確認依賴順序。
整包引入:載入 bootstrap.js 或壓縮版 bootstrap.min.js。
切勿同時引入這兩個檔案——它們都包含全部插件,重複載入會造成事件被重複綁定,同一個動作觸發兩次。
所有插件都依賴 jQuery,因此 jQuery 必須排在插件之前。具體支援的 jQuery 版本可查 bower.json。
僅靠 data 屬性就能使用所有 Bootstrap 插件,不需要寫任何 JavaScript。這是 Bootstrap 中的一等 API,也應該是你的首選方式。
某些情況下可能需要關閉它,方法是解除以 data-api 為命名空間、綁定在文件上的事件:
$(document).off('.data-api')
若只想關閉某個特定插件,在命名空間前加上插件名稱即可:
$(document).off('.alert.data-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 互動時最重要的一條原則:要攔截就在現在式,要收尾就在過去式。