Latest web development tutorials

Bootstrap 插件概覽

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

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

  • 單獨引用 :使用Bootstrap的個別的*.js文件。一些插件和CSS 組件依賴於其他插件。 如果您單獨引用插件,請先確保弄清這些插件之間的依賴關係。
  • 編譯(同時)引用 :使用bootstrap.js或壓縮版的bootstrap.min.js
    不要嘗試同時引用這兩個文件,因為bootstrap.jsbootstrap.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()    
 // 初始化為不支持鍵盤$("#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