Используйте компоненты Bootstrap с 13-ю обычными плагинами jQuery.
Если вы загрузили последнюю версию Bootstrap, оба файла bootstrap.js и bootstrap.min.js содержат все плагины, перечисленные на странице.
Вы можете использовать исключительно все плагины Bootstrap с использованием разметки API, не написав ни одной строки JavaScript. API — это первый класс Bootstrap, он должен быть вашим первым решением при выборе плагина.
Это говорит о том, что в некоторых ситуациях желательно выключить полную функциональность. По этой причине мы также предоставляем возможность отключить атрибут данных API путем отсоединения всех событий`’data-api’`. Это выглядит подобным образом:
Кроме того, чтобы выбрать специальный плагин, просто поместите название плагина в поле ввода имён вместе с названием data-api, как показано в примере:
Мы также уверены в том, что вам следует использовать абсолютно все плагины Bootstrap, применяя JavaScript API. Все доступные API — это единичные методы, образующие цепочку, они выполняют целые серии действий.
Все методы должны принимать дополнительный объект опций, строку, которая нацелена на конкретный метод, или ничего (что включает в себя плагин с функциями по умолчанию):
В каждом плагине можно увидеть конструктор необработанных данных. Это вы найдете в свойствах конструктора. $.fn.popover.Constructor
. Если вы хотите вызвать какой-либо определенный плагин, извлеките его прямо из элемента: $('[rel=popover]').data('popover')
.
Bootstrap использует обыкновенные события для большинства уникальных действий плагинов. В большинстве случаев, они встречаются в форме инфинитива и в форме причастия прошедшего времени — началом события вызывается инфинитив (ex. show
) , а его форма прошедшего времени (ex. shown
) вызывается завершением действия.
Все инфинитивные события предотвращают использование функций по умолчанию. Это обеспечивает возможность остановить выполнение действия перед тем, как оно начнется.
Для простого эффекта перехода добавьте элемент bootstrap-transition.js к другим файлам JS. Если вы используете компилированный минимизированный элемент bootstrap.js, нет нужды добавлять этот элемент — он уже есть.
Немного примеров плагина перехода:
Модальные элементы — это хорошо налаженные, но гибкие, с окнами подсказок, с минимальными функциональными требованиями и толковыми настройками по умолчанию.
Модальный элемент отображается с заголовком, телом, и набором действий в нижнем колонтитуле.
Некое изящное тело…
Переключите модальный элемент JavaScript нажатием кнопки внизу. Элемент соскользнет вниз и появится поверх затененной страницы.
Активируйте модальный элемент без использования JavaScript. Установите data-toggle="modal"
в элемент контроллера, как кнопку, вместе с data-target="#foo"
или href="#foo"
чтобы указать на конкретный модальный элемент для переключения.
Вызовите модальный элемент с id myModal
одной строкой JavaScript:
Опции могут быть заданы с помощью атрибутов данных или JavaScript. Для атрибутов данных, присоедините название опции к data-
, как в data-backdrop=""
.
Название | Тип | По умолчанию | Описание |
---|---|---|---|
фон | boolean | true | Включает элемент modal-backdrop. Кроме того, указывает на статичность отмены закрытия окна при клике на задний фон. |
клавиатура | boolean | true | Выбирает модальный элемент посредством нажатой клавиши «escape» |
показ | boolean | true | Показывает инициализируемый модальный элемент. |
удаленный | path | false | Если поддерживается удаленный URL, содержимое загружается с помощью элемента jQuery загрузки и вставляется в .modal-body . Если вы используете api, вы также можете использовать тег href для указания удаленного источника. Ниже показан пример:
|
Активирует содержимое как модальный элемент. Допускает применение дополнительной опции object
.
Позволяет переключать модальный элемент вручную.
Позволяет открыть модальный элемент вручную.
Позволяет скрыть модальный элемент вручную.
Bootstrap поддерживает вызов событий для работы с всплывающими элементами..
Событие | Описание |
---|---|
show | Это событие срабатывает немедленно после вызова метода show . |
shown | Это событие срабатывает после отображения всплывающего элемента и окончания анимации. |
hide | Это событие срабатывает немедленно после вызова метода hide . |
hidden | Это событие срабатывает после скрытия всплывающего элемента и окончания анимации. |
Добавляйте выпадающие списки к любому элементу, включая панель навигации, вкладки и кнопки.
Добавьте data-toggle="dropdown"
к ссылке или кнопке, чтобы переключить выпадающий список.
Чтобы сохранить целостность URL, используйте атрибут data-target
вместо href="#"
.
Вызовите выпадающий список при помощи JavaScript:
Нет
Программный api для активации меню для заданной панели или таблицы навигации.
Плагин ScrollSpy предназначен для автоматического обновления элементов навигации, основанных на прокрутке. Прокрутите текст внутри элемента ниже, для демонстрации работы плагина. Элементы, включенные в выпадающий список, также обновляются..
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney’s photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven’t heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney’s vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney’s quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.
In incididunt echo park, officia deserunt mcsweeney’s proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven’t heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney’s photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven’t heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven’t heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Для дополнения вашего меню плагином scrollspy добавьте атрибут data-spy="scroll"
к элементу, за прокруткой в котором необходимо следить (обычно это элемент body) и с помощью data-target=".navbar"
выберите, какой элемент выбудете использовать. Вы захотите применять scrollspy с компонентом .nav
.
Вызовите scrollspy с помощью JavaScript:
<a href="#home">home</a>
должна ссылаться на DOM-элемент <div id="home"></div>
.Используйте в динамическом контенте, который изменяет DOM. Вам необходимо вызвать метод refresh для корректной работы плагина scrollspy:
Опции могут быть заданы атрибутами данных или JavaScript. Для атрибутов данных добавьте название опции в data-
, как и в data-offset=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
значение по умолчанию | номер | 10 | Отступ в пикселах при расчете позиции прокрутки. |
Событие | Описание/th> |
---|---|
активировать | Это событие срабатывает немедленно каждый раз при активации нового элемента в навигации. |
Добавляет быструю динамическую функциональность для перехода по вкладкам или локальному контенту, даже с помощью выпадающего меню.
Raw denim you probably haven’t heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney’s marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney’s organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven’t heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Активируйте переключаемые вкладки с помощью JavaScript (каждая вкладка должна быть активирована отдельно):
Вы можете активировать переключаемые вкладки несколькими способами:
У Вас есть возможность активировать вкладки без использования javascript, для этого добавьте атрибут data-toggle="tab"
или data-toggle="pill"
к элементу. Добавьте классы nav
и nav-tabs
в список ul
для стилизации вкладок Bootstrap.
Метод активирует вкладку и ссылающийся контейнер. Вкладка должна ссылаться на контейнеры data-target
или href
в DOM.
Событие | Описание |
---|---|
show | Это событие немедленно срабатывает при показе вкладки, но до показа новой вкладки. Используйте event.target и event.relatedTarget для отображения активной вкладки и, соответственно, предыдущей активной вкладки (по возможности). |
shown | Это событие немедленно срабатывает при показе вкладки, но после показа новой вкладки. Используйте event.target и event.relatedTarget для отображения активной вкладки и, соответственно, предыдущей активной вкладки (по возможности). |
Вдохновленные плагином jQuery.tipsy от Джейсона Фрейма, мы создали обновленные всплывающие подсказки, не основанные на картинках, и использовали CSS3 для анимации и атрибут data-attribute для запоминания локальных названий.
Наведите курсор на ссылки ниже, чтобы увидеть всплывающие подсказки:
Tight pants next level keffiyeh you probably haven’t heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney’s fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney’s cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.
Вызов всплывающей подсказки с помощью JavaScript:
Опции могут быть заданы через data-атрибуты или JavaScript. Для дата-атрибутов добавьте название опции к data-
, как и в data-animation=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
animation | boolean | true | Затеняет подсказки с помощью CSS |
html | boolean | true | Вставляет html в подсказку. В значении false, метод jquery text будет использоваться для вставки содержимого в dom. Используйте текст, чтобы не волноваться об атаках XSS. |
placement | string|function | ‘top’ | Позиционирование подсказки — top | bottom | left | right |
selector | string | false | Если имеется селектор, объекты tooltip (всплывающие подсказки) будут направлены на соответствующие цели. |
title | string | function | » | Значение подсказки по умолчанию если тег `title` не указан |
trigger | string | ‘hover’ | Задает тип события при котором происходит показ/скрытие подсказки- click | hover | focus | manual |
delay | number | object | 0 | Задержка перед показом/скрытием подсказки в миллисекундах (ms) — не применяется для trigger с типом manual
Если задано число, то задержка применяется в обоих случаях — для показа и для скрытия. Структура объекта: |
В указании параметров участвуют data-api всплывающих подсказок (Tooltip) и информационных блоков (Popover). Если вы хотите их использовать, просто укажите опцию селектора.
Добавляет подсказку к элементам..
Воспроизводит показ подсказки.
Скрывает подсказку.
Показывает и скрывает подсказку.
Скрывает и уничтожает подсказку.
Добавляет всплывающий контент к элементам, как на iPad. Может добавлять контент к каждому элементу для хранения второстепенной информации. Наведите курсор на кнопку, чтобы запустить показ информационного блока. Требует наличие информационного блока (Tooltip).
Доступны четыре опции: top, right, bottom, and left aligned.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Нет разметки, поскольку информационные блоки (popovers) сгенерированы посредством JavaScript и содержимым в атрибуте data
.
Разрешение использования информационных блоков (popovers) посредством JavaScript:
Опции могут быть заданы через data-атрибуты или JavaScript. Для data-атрибутов прибавьте название опции к data-
, как и к data-animation=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
animation | boolean | true | Затеняет информационные блоки с помощью CSS |
html | boolean | true | Вставляет html в информационные блоки. В значении false, метод jquery text будет использоваться для вставки содержимого в dom. Используйте текст, чтобы не волноваться об атаках XSS. |
placement | string|function | ‘right’ | Позиционирование информационного блока — top | bottom | left | right |
selector | string | false | Если имеется селектор, объекты popover (информационные блоки) будут направлены на соответствующие цели. |
trigger | string | ‘click’ | Задает тип события при котором происходит показ/скрытие информационного блока — click | hover | focus | manual |
title | string | function | » | Значение информационного блока по умолчанию если тег `title` не указан |
content | string | function | » | Значение информационного блока по умолчанию если атрибут `data-content` не указан |
delay | number | object | 0 | Задержка перед показом/скрытием информационного блока в миллисекундах (ms) — не применяется для trigger с типом manual
Если задано число, то задержка применяется в обоих случаях — для показа и для скрытия. Структура объекта: |
В указании параметров участвуют data-api всплывающих подсказок (Tooltip) и информационных блоков (Popover). Если вы хотите их использовать, просто укажите опцию селектора.
Добавляет всплывающие контент к элементам.
Запускает показ всплывающего контента.
Скрывает элемент с всплывающим контентом.
Переключает показ/скрытие всплывающего контента.
Скрывает и разрушает элемент всплывающего контента.
Плагин сообщений добавляет сообщению функцию скрытия .
Измените данные и попробуйте ввести их снова. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Добавьте скрытие сообщений посредством JavaScript:
Просто добавьте data-dismiss="alert"
в вашу закрывающую кнопку чтобы автоматически задать ей функцию закрытия сообщения..
Добавляет функционал скрипта ко всем сообщениям на странице. Для анимации ваших сообщений добавьте к ним классы .fade
и .in
.
Закрывает сообщение.
Класс сообщений Bootstrap имеет несколько событий при закрытии сообщения.
Событие | Описание |
---|---|
close | Это событие срабатывает немедленно после вызова метода close . |
closed | Это событие срабатывает сразу после закрытия сообщения, включая время перемещения. |
Основные стили и гибкая поддержка сворачиваемых компонентов, таких, как навигация или «гармошка».
* Требуется плагин Transitions.
Используя плагин collapse, мы создали простой пример в виде «гармошки» из группы горизонтальных вкладок::
Вы также можете использовать плагин без разметки «гармошки». Создайте кнопку-переключателя для расширения или сворачивания другого элемента.
Просто добавьте data-toggle="collapse"
и data-target
к элементу для автоматической активации плагина. Атрибут data-target
в качестве значения принимает css-селектор. Не забудьте добавить класс collapse
к сворачиваемым элементам. Для создания по умолчанию раскрытого элемента добавьте дополнительный класс in
.
Для управления группой элементов как в примере выше, добавьте атрибут с селектором родительского элемента data-parent="#selector"
. Вернитесь к примеру выше для рассмотрении в действии.
Активируйте самостоятельно:
Опции могут быть заданы с помощью data-атрибутов или JavaScript. Для дата-атрибутов добавьте название опции к data-
, как и к data-parent=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
parent | selector | false | Пункт появляется, если селектор, а затем все складывающиеся элементы в родительской категории будут закрыты (наподобие обычного аккордеона). |
toggle | boolean | true | Переключает сворачиваемые элементы. |
Активирует содержимое как сворачиваемый элемент. Принимает дополнительные опции в виде object
.
Переключает показ/скрытие элемента.
Показывает (раскрывает) все элементы.
Скрывает все элементы.
Класс collapse от Bootstrap имеет ряд доступных событий.
Событие | Описание |
---|---|
show | Срабатывает немедленно при вызове метода show . |
shown | Срабатывает немедленно после показа элемента и завершения сворачивания. (Для завершения ожидается переход (transitions) в css). |
hide | Срабатывает немедленно при вызове метода hide . |
hidden | Срабатывает немедленно после скрытия элемента и завершения сворачивания. (Для завершения ожидается переход (transitions) в css). |
TПлагин для цикличного слайдинга между элементами, по аналогии с каруселью.
…
Вызывает «карусель» вручную:
Опции могут быть заданы через data-атрибуты или JavaScript. Для data-атрибутов добавьте название опции к data-
, как и к data-interval=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
interval | number | 5000 | Количество времени между автоматической сменой слайдов. Если установить значение false, карусель не будет запущена автоматически. |
pause | string | «hover» | Ставит показ слайдов на паузу при фокусе «карусели» и возобновляет показ при потере фокуса. |
Инициализирует «карусель» с дополнительными опциями object
и начинает показ слайдов.
Запускает цикл слева направо.
Останавливает показ элементов.
Переход на указанный элемент (Начиная с 0, по аналогии с массивом).
Переход к предыдущему элементу.
Переход к следующему элементу.
«Карусель» Bootstrap имеет два события:
Событие | Описание |
---|---|
slide | Срабатывает каждый раз при вызове метода slide . |
slid | Срабатывает, когда «карусель» закончила показ слайдов. |
Основной плагин для быстрого создания строки поиска с опережающим вводом с клавиатуры для текста любой формы.
Добавьте data-атрибуты для регистрации элемента опережающего ввода с клавиатуры, как показано в примере выше.
Вызовите опцию опережающего набора с клавиатуры при помощи:
Опции могут быть заданы посредством data-атрибутов или JavaScript. Для data-атрибутов добавьте название опции к data-
, как и к data-source=""
.
Название | тип | по умолчанию | описание |
---|---|---|---|
source | array, function | [ ] | Источник с искомыми значениями. Может быть массивом или функцией. Функция задается двумя значениями, значение query в поле ввода и обратный вызовprocess . Функция может использоваться одновременно, возвращая исходные данные или не совпадать во времени — через единичное значение обратного вызова process . |
items | number | 8 | Максимальное количество показываемых значений в выпадающем меню.. |
minLength | number | 1 | Минимальное количество символов, необходимое для запуска предложения автозаполнения |
matcher | function | case insensitive | Метод используется для поиска совпадений. Принимает только одно значение — item . Доступ к текущему запросу можно получить через this.query . Возвращает true , если значение совпало. |
sorter | function | exact match, case sensitive, case insensitive |
Метод используется для сортировки совпадающих значений. Принимает только одно значение — items . Доступ к текущему запросу можно получить через this.query . |
highlighter | function | highlights all default matches | Метод используется для выделения совпавших значений. Принимает только одно значение item . Возвращает html. |
Инициализирует опережающий ввод с клавиатуры.
Вложенная навигация слева как демонстрация плагина Аффикс.
Чтобы легко применить аффикс к любому элементу, просто добавьте data-spy="affix"
к элементу, за которым нужно следить. Затем используйте смещение, чтобы обозначить позицию элемента во включенном и выключенном режимах.
affix
, affix-top
, и affix-bottom
. Обязательно проверьте потенциально сворачиваемый родительский элемент при активном аффиксе и его содержимое при нормальном протекании процесса на странице.Вызовите плагин Аффикс посредством JavaScript:
Используя аффикс в конъюнкции с добавлением или удалением элементов в DOM, вы можете вызвать метод обновления:
Опции могут быть заданы посредством data-атрибутов или JavaScript. Для data-атрибутов добавьте название опции к data-
, как и к data-offset-top="200"
.
Название | тип | по умолчанию | описание |
---|---|---|---|
offset | number | function | object | 10 | Пикселы на экране смещаются при расчете позиции прокрутки. Если задано только одно число, смещение будет применяться в обоих направлениях: вверх-вниз и вправо-влево. Для получения одного направления или множественных уникальных смещений просто задайте объекту offset: { x: 10 } . используйте функцию, если вам нужно представить смещение динамически (полезно для некоторых чувствительных вариантов дизайна). |