Bootstrap <基礎三十一>插件概覽

在前面佈局組件中所討論到的組件僅僅是個開始。Bootstrap 自帶 12 種 jQuery 插件，擴展了功能，能夠給站點添加更多的互動。即便不是一名高級的 JavaScript 開發人員，也能夠着手學習 Bootstrap 的 JavaScript 插件。利用 Bootstrap 數據 API（Bootstrap Data API），大部分的插件能夠在不編寫任何代碼的狀況被觸發。

站點引用 Bootstrap 插件的方式有兩種：css

單獨引用：使用 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的調用形式一致）。例如：html

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

全部的方法均可以接受一個可選的選項對象做爲參數，或者一個表明特定方法的字符串，或者不帶任何參數（這種狀況下，將會初始化插件爲默認行爲），以下所示：git

// 初始化爲默認行爲
$("#myModal").modal()    
 // 初始化爲不支持鍵盤               
$("#myModal").modal({ keyboard: false })  
// 初始化並當即調用 show
$("#myModal").modal('show')

每一個插件在 Constructor 屬性上也暴露了其原始的構造函數：$.fn.popover.Constructor。若是你想獲取某個特定插件的實例，能夠直接經過頁面元素獲取：github

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

避免命名空間衝突

某些時候 Bootstrap 插件可能須要與其餘 UI 框架一塊兒使用。在這種狀況下，可能會發生命名空間衝突。若是不幸發生了這種狀況，你能夠經過調用插件的 .noConflict 方法恢復其原始值。編程

// 返回 $.fn.button 以前所賦的值
var bootstrapButton = $.fn.button.noConflict() 
// 爲 $().bootstrapBtn 賦予 Bootstrap 功能                           
$.fn.bootstrapBtn = bootstrapButton

事件

Bootstrap 爲大多數插件的獨特行爲提供了自定義事件。通常來講，這些事件有兩種形式：json

動詞不定式：這會在事件開始時被觸發。例如 ex: show。動詞不定式事件提供了 preventDefault 功能。這使得在事件開始前能夠中止操做的執行。
```
$('#myModal').on('show.bs.modal', function (e) {
// 阻止模態框的顯示
  if (!data) return e.preventDefault() 
})
```
過去分詞形式：這會在動做執行完畢以後被觸發。例如 ex: shown。