# 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](https://github.com/twbs/bootstrap/blob/v3.0.2/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() // 初始化為不支持鍵盤 $("#myModal").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 賦予 Bootstrap 功能 $.fn.bootstrapBtn = bootstrapButton ``` ## 事件 Bootstrap 為大多數插件的獨特行為提供了自定義事件。一般來說，這些事件有兩種形式： * **動詞不定式**：這會在事件開始時被觸發。例如 _ex: show_。動詞不定式事件提供了 _preventDefault_ 功能。這使得在事件開始前可以停止操作的執行。 ``` $('#myModal').on('show.bs.modal', function (e) { // 阻止模態框的顯示 if (!data) return e.preventDefault() }) ``` * **過去分詞形式**：這會在動作執行完畢之后被觸發。例如 _ex: shown_。