Bootstrap Обзор плагинов
Ранеекомпоненты макетаКомпоненты, рассмотренные в предыдущих главах, — это только начало. Bootstrap поставляется с 12 плагинами jQuery, которые расширяют его функциональность и могут добавить больше интерактивности вашему сайту. Даже если вы не старший JavaScript-разработчик, вы можете начать изучать JavaScript-плагины Bootstrap. С помощью Bootstrap Data API большинство плагинов можно активировать без написания какого-либо кода.
Существует два способа подключения плагинов Bootstrap на сайте:
- Отдельные подключения: используйте отдельные файлы Bootstrap*.js. Некоторые плагины и CSS-компоненты зависят от других плагинов. Если вы подключаете плагины по отдельности, сначала убедитесь, что понимаете зависимости между этими плагинами.
- Скомпилированные (объединённые) подключения: используйтеbootstrap.jsили минифицированную версиюbootstrap.min.js。
Не пытайтесь подключать оба файла одновременно, потому чтоbootstrap.jsиbootstrap.min.jsоба содержат все плагины.
атрибуты 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。