Bootstrap 插件概覽

在前面 布局組件 章節(jié)中所討論到的組件僅僅是個(gè)開(kāi)始。Bootstrap 自帶 12 種 jQuery 插件，擴(kuò)展了功能，可以給站點(diǎn)添加更多的互動(dòng)。即使您不是一名高級(jí)的 JavaScript 開(kāi)發(fā)人員，您也可以著手學(xué)習(xí) Bootstrap 的 JavaScript 插件。利用 Bootstrap 數(shù)據(jù) API（Bootstrap Data API），大部分的插件可以在不編寫(xiě)任何代碼的情況被觸發(fā)。

站點(diǎn)引用 Bootstrap 插件的方式有兩種：

  • 單獨(dú)引用：使用 Bootstrap 的個(gè)別的 *.js 文件。一些插件和 CSS 組件依賴(lài)于其他插件。如果您單獨(dú)引用插件，請(qǐng)先確保弄清這些插件之間的依賴(lài)關(guān)系。

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

    不要嘗試同時(shí)引用這兩個(gè)文件，因?yàn)?bootstrap.js 和 bootstrap.min.js 都包含了所有的插件。
所有的插件依賴(lài)于 jQuery。所以必須在插件文件之前引用 jQuery。請(qǐng)?jiān)L問(wèn) bower.json 查看 Bootstrap 當(dāng)前支持的 jQuery 版本。

data 屬性

  • 你可以?xún)H僅通過(guò) data 屬性 API 就能使用所有的 Bootstrap 插件，無(wú)需寫(xiě)一行 JavaScript 代碼。這是 Bootstrap 中的一等 API，也應(yīng)該是你的首選方式。

  • 話又說(shuō)回來(lái)，在某些情況下可能需要將此功能關(guān)閉。因此，我們還提供了關(guān)閉 data 屬性 API 的方法，即解除以 data-api 為命名空間并綁定在文檔上的事件。就像下面這樣：

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

  • 如需關(guān)閉一個(gè)特定的插件，只需要在 data-api 命名空間前加上該插件的名稱(chēng)作為命名空間即可，如下所示：

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

編程方式的 API

我們?yōu)樗?Bootstrap 插件提供了純 JavaScript 方式的 API。所有公開(kāi)的 API 都是支持單獨(dú)或鏈?zhǔn)秸{(diào)用方式，并且返回其所操作的元素集合（注：和jQuery的調(diào)用形式一致）。例如：

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

所有的方法都可以接受一個(gè)可選的選項(xiàng)對(duì)象作為參數(shù)，或者一個(gè)代表特定方法的字符串，或者不帶任何參數(shù)（這種情況下，將會(huì)初始化插件為默認(rèn)行為），如下所示：

// 初始化為默認(rèn)行為
$("#myModal").modal()    
 // 初始化為不支持鍵盤(pán)               
$("#myModal").modal({ keyboard: false })  
// 初始化并立即調(diào)用 show
$("#myModal").modal('show')

每個(gè)插件在 Constructor 屬性上也暴露了其原始的構(gòu)造函數(shù)：$.fn.popover.Constructor。如果您想獲取某個(gè)特定插件的實(shí)例，可以直接通過(guò)頁(yè)面元素獲?。?/p>

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

避免命名空間沖突

某些時(shí)候 Bootstrap 插件可能需要與其他 UI 框架一起使用。在這種情況下，可能會(huì)發(fā)生命名空間沖突。如果不幸發(fā)生了這種情況，你可以通過(guò)調(diào)用插件的 .noConflict 方法恢復(fù)其原始值。

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

事件

Bootstrap 為大多數(shù)插件的獨(dú)特行為提供了自定義事件。一般來(lái)說(shuō)，這些事件有兩種形式：

  • 動(dòng)詞不定式：這會(huì)在事件開(kāi)始時(shí)被觸發(fā)。例如 ex: show。動(dòng)詞不定式事件提供了 preventDefault 功能。這使得在事件開(kāi)始前可以停止操作的執(zhí)行。

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

  • 過(guò)去分詞形式：這會(huì)在動(dòng)作執(zhí)行完畢之后被觸發(fā)。例如 ex: shown。

相關(guān)教程

CSS教程

jQuery教程