Bootstrap 外掛程式概覽


在前面 佈局元件 章節中所討論到的元件只是個開始。 Bootstrap 自備 12 種 jQuery 插件，擴展了功能，可以為網站添加更多的互動。即使您不是高階的 JavaScript 開發人員，您也可以著手學習 Bootstrap 的 JavaScript 外掛程式。利用 Bootstrap 資料 API（Bootstrap Data API），大部分的插件可以在不寫任何程式碼的情況被觸發。

網站引用Bootstrap 外掛程式的方式有兩種：

  • # 單獨引用：使用Bootstrap 的個別的*.js 文件。一些插件和 CSS 元件依賴其他插件。如果您單獨引用插件，請先確保弄清楚這些插件之間的依賴關係。

    編譯（同時）引用：使用 bootstrap.js 或壓縮版的 bootstrap.min.js。

    不要嘗試同時引用這兩個文件，因為 bootstrap.js 和 bootstrap.min.js 都包含了所有的插件。
所有的外掛都依賴 jQuery。所以必須在插件檔案之前引用 jQuery。請造訪 bower.json 查看 Bootstrap 目前支援的 jQuery 版本。

data 屬性

  • 你可以只透過 data 屬性 API 就能使用所有的 Bootstrap 插件，而無需寫一行 JavaScript 程式碼。這是 Bootstrap 中的一等 API，也應該是你的首選方式。

  • 話又說回來，在某些情況下可能需要將此功能關閉。因此，我們也提供了關閉 data 屬性 API 的方法，即解除以 data-api 為命名空間並綁定在文件上的事件。就像下面這樣：      

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

  • 如需關閉一個特定的插件，只需要在data-api 命名空間前加上該插件的名稱作為命名空間即可，如下所示：

##$(document ).off('.alert.data-api')
程式設計方式的API

我們為所有Bootstrap 外掛程式提供了純JavaScript 方式的API。所有公開的 API 都是支援單獨或鍊式呼叫方式，並且傳回其所操作的元素集合（註：和jQuery的呼叫形式一致）。例如：

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

所有的方法都可以接受一個可選的選項物件作為參數，或者一個代表特定方法的字串，或者不帶任何參數（這種情況下，將會初始化插件為預設行為），如下所示：

// 初始化為預設行為
$("#myModal").modal()    
 // 初始化為不支援鍵盤         .modal({ keyboard: false })  
// 初始化並立即呼叫 show
$("#myModal").modal('show')
#每個外掛程式在

Constructor 屬性上也暴露了其原始的建構子：$.fn.popover.Constructor。如果您想要取得某個特定外掛程式的實例，可以直接透過頁面元素取得：

$('[rel=popover]').data('popover').
避免命名空間衝突

某些時候Bootstrap 外掛可能需要與其他UI 框架一起使用。在這種情況下，可能會發生命名空間衝突。如果不幸發生了這種情況，你可以透過呼叫插件的

.noConflict 方法來恢復其原始值。

// 回傳 $.fn.button 之前所賦的值
var bootstrapButton = $.fn.button.noConflict() 
// 為 $().bootstrapBtn t() 
// 為 $().bootstrapBtn 功能        
$.fn.bootstrapBtn = bootstrapButton

事件

Bootstrap 為大多數外掛程式的獨特行為提供了自訂事件。一般來說，這些事件有兩種形式：

  • 動詞不定詞：這會在事件開始時被觸發。例如 ex: show。動詞不定式事件提供了 preventDefault 功能。這使得在事件開始前可以停止操作的執行。

$('#myModal').on('show.bs.modal', function (e) {
// 阻止模態方塊的顯示
  if (!data) return e.preventDefault() 
})

  • 過去分詞形式：這會在動作執行完畢之後被觸發。例如 ex: shown。


→