Bootstrap Обзор плагинов

Ранеекомпоненты макетаКомпоненты, рассмотренные в предыдущих главах, — это только начало. Bootstrap поставляется с 12 плагинами jQuery, которые расширяют его функциональность и могут добавить больше интерактивности вашему сайту. Даже если вы не старший JavaScript-разработчик, вы можете начать изучать JavaScript-плагины Bootstrap. С помощью Bootstrap Data API большинство плагинов можно активировать без написания какого-либо кода.

Существует два способа подключения плагинов Bootstrap на сайте:

  • Отдельные подключения: используйте отдельные файлы Bootstrap*.js. Некоторые плагины и CSS-компоненты зависят от других плагинов. Если вы подключаете плагины по отдельности, сначала убедитесь, что понимаете зависимости между этими плагинами.
  • Скомпилированные (объединённые) подключения: используйтеbootstrap.jsили минифицированную версиюbootstrap.min.js。
    Не пытайтесь подключать оба файла одновременно, потому чтоbootstrap.jsиbootstrap.min.jsоба содержат все плагины.
Все плагины зависят от jQuery. Поэтому jQuery должен быть подключён перед файлами плагинов. Посетитеbower.json, чтобы проверить версию jQuery, поддерживаемую в настоящее время Bootstrap.

атрибуты data

  • Вы можете использовать все плагины Bootstrap просто через API атрибутов data, не написав ни единой строки кода JavaScript. Это полноценный API в Bootstrap, и он должен быть вашим предпочтительным подходом.
  • Тем не менее, в некоторых случаях может потребоваться отключить эту функцию. Поэтому мы также предоставляем способ отключить API атрибутов data, а именно отвязать события, которые имеют пространство имёнdata-apiи привязаны к документу. Вот так:
    $(document).off('.data-api')
    
  • Чтобы отключить конкретный плагин, просто добавьте имя плагина в качестве префикса к пространству имён data-api, как показано ниже:
    $(document).off('.alert.data-api')
    

Программный API

Мы предоставляем чистый JavaScript API для всех плагинов Bootstrap. Все публичные API поддерживают одиночные или цепочечные вызовы и возвращают коллекцию элементов, с которыми они работают (примечание: согласно соглашению о вызовах jQuery). Например:

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

Все методы могут принимать необязательный объект options в качестве параметра, либо строку, представляющую конкретный метод, либо не принимать параметров (в этом случае плагин будет инициализирован с поведением по умолчанию), как показано ниже:

// 初始化为默认行为
$("#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            

Events

Bootstrap предоставляет пользовательские события для уникального поведения большинства плагинов. Обычно эти события бывают двух видов:

  • Инфинитив: Это событие вызывается в начале события. Напримерex: show. Инфинитивные события предоставляютpreventDefaultфункциональность. Это позволяет остановить выполнение операции до начала события.
    $('#myModal').on('show.bs.modal', function (e) {
    // 阻止模态框的显示
      if (!data) return e.preventDefault() 
    })
    
  • Форма причастия прошедшего времени: Это событие вызывается после завершения действия. Напримерex: shown。
Другие расширения