Отдельно или с компиляцией

Плагины можно подключать по отдельности (с помощью отдельных файлов Bootstrap *.js ) или все сразу (используя bootstrap.js или уменьшенный вариант bootstrap.min.js).

Не используйте оба файла.

Каждый из файлов bootstrap.js и bootstrap.min.js содержит полный набор плагинов.

Зависимости плагинов

Некоторые плагины и компоненты CSS зависят от других плагинов. Если вы подключаете плагины по одному, проверьте их на наличие этих зависимостей по руководству. Обратите внимание также на то, что все плагины связаны с jQuery (это означает, что jQuery нужно подключить перед плагинами).

Атрибуты данных

Можно использовать все плагины Bootstrap с помощью API разметки, не написав ни единой строчки JavaScript. При использовании плагинов в первую очередь следует пользоваться высокоуровневым APIBootstrap.

Считается, что в некоторых ситуациях лучше отключить данный функционал. Поэтому мы также предусмотрели возможность отключения API атрибутов данных при анбайнде всех событий в документе, у которого пространство имен использует data-api. Вот, как это выглядит:

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

В качестве альтернативы, указания специфического плагина, просто включите имя плагина как неймспейс вместе дата эй-пи-ай неймспейс:

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

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

Мы также считаем, вы должны быть в состоянии использовать все JavaScript плагины чисто через Bootstrap API. Все открытые API - одинокие, цепные методы и действуют в соответствии возврата коллекции.

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

Все методы должны принимать дополнительные функции объектов, строки которых нацелены на конкретный метод, или ничего (который инициирует плагин с поведением по умолчанию)

$("#myModal").modal()                      // initialized with defaults
$("#myModal").modal({ keyboard: false })   // initialized with no keyboard
$("#myModal").modal('show')                // initializes and invokes show immediately</p>

Каждый плагин также показывает исходный конструктор на свойство Constructor: $.fn.popover.Constructor. Если вы хотите получить особую сущность плагина, вы можете получить это прямо из элемента: $('[rel=popover]').data('popover').

Без конфликта

Иногда бывает необходимо использовать {Bootstrap плагины с другими механизмами UI. В этих условиях, конфликт пространства имен может время от времени происходить. Если это произойдет, вы можете вызвать .noConflict на плагине, которому вы хотите вернуть значение.

var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
$.fn.bootstrapBtn = bootstrapButton            // give $().bootstrapBtn the Bootstrap functionality

События

Bootstrap поддерживает события которые вы можете изменять для большинства уникальных действий плагинов. В общем случаях, они выражены в форме глагола неопределенной формы и причастия прошедшего времени (на пример: show) вызывается в начале события, и причастия прошедшего времени (на пример: shown) вызывается по завершению действия.

По состоянию 3.0.0, все Bootstrap события имеют пространство имен.

Все неопределенные события предоставляют preventDefault функциональность. Это дает возможность остановить выполнение действия до его начала.

$('#myModal').on('show.bs.modal', function (e) {
  if (!data) return e.preventDefault() // stops modal from being shown
})

Третья сторона библиотеки

Bootstrap официально не поддерживает третью сторону JavaScript библиотек наподобие Прототипа или JQuery UI. Несмотря на .noConflict и события пространства имен, могут возникнить проблемы с совместимостью, которые вам нужно будет исправить по своему усмотрению. Запросите лист рассылки, если вам необходима помощь.

О переходах

Для простых переходны эффектов, включите transition.js вместе с другими Джаваскрипт файлами. Если вы используете компилированный (или минифицированный) bootstrap.js, тогда не надо включать это - оно уже включено.

Что внутри

Transition.js это базовый хелпер для transitionEnd событий как эмуляция CSS переходов. Его используют другие плагины для проверки поддержки ЦСС переходов и перехвата событий перехода.

Дополнительные шаблоны

Модали организованные, но гибкие, подсказки для диалогового окна с минимальной необходимой функциональностью и интеллектуальными настройками по умолчанию.

Статический пример

Генерированный модаль с заголовком, телом и набором действий в нижней колонтитуле.

<div class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Modal title</h4>
      </div>
      <div class="modal-body">
        <p>One fine body&hellip;</p>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->
</div><!-- /.modal -->

Живая демонстрация

Переключите модаль через JavaScript, нажатием на кнопку ниже. Оно будет скользить вниз и исчезать из верхней части страницы.

  <!-- Button trigger modal -->
<a data-toggle="modal" href="#myModal" class="btn btn-primary btn-lg">Launch demo modal</a>

<!-- Modal -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Modal title</h4>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->span>
</div><!-- /.modal -->

Создание модалей доступным

Будьте уверене что добавили role="dialog" в ваш основной модальный контейнер. В примере выше, div#myModal.
Также, aria-labelledby аттрибут ссылки на ваш модальный заголовок. В этом примере, h4#myModalLabel.
Наконец, aria-hidden="true" говорит вспомогательным технологиям опустить элементы ДОМа.
В дополнение, вы можете дать описание вашему модальному диалогу. Использую aria-describedby атрибут в основном модальном контейнер <div> для того чтобы указать на описание (это не показано в примере выше).

Использование

Через аттрибутивные данные

Активируйте модальное окно без написания JavaScript. Установите data-toggle="modal" на элемент контроллера, как кнопка, вместе с data-target="#foo" или href="#foo" нацеленные на вызов указанного модального окна.

<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>

Через JavaScript

Вызвать модаль с помощью айди myModal с единичной линией JavaScript.

$('#myModal').modal(options)

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-backdrop=""

имя вид по умолчанию описание
фон логический true Включает элемент задника модального окна. Альтернатива, укажите static для задника которое не закрывает окно по клику.
клавиатура логический true Закрытие модаля возникает при нажатии исчезнувшей клавиши.
показ логический true Показывает модаль при инициализации.
удаленный путь false

Если есть удаленный УРЛ, контент может быть загружен через jQuery load метод и вставлен в корневой элемент модального окна. Если вы используете эй-пи-ай данные, у вас альтернатива использовать href атрибут для указания удаленного ресурса. Пример показан ниже:

<a data-toggle="modal" href="remote.html" data-target="#modal">Click me</a>

Методы

.modal(options)

Активизирует ваше содержание как модаль. Принимает функциональную опцию object.

$('#myModal').modal({
  keyboard: false
})

.modal('toggle')

Вручную переключает модаль.

$('#myModal').modal('toggle')

.modal('show')

Вручную открывает модаль.

$('#myModal').modal('show')

.modal('hide')

Вручную скрывает модаль.

$('#myModal').modal('hide')

События

Bootstrap модальные классы показывают несколько событий для привязки к функционалу модального окна.

Вид события Описание
show.bs.modal Это событие возникает сразу же, когда show метод экземпляра вызван.
shown.bs.modal Это событие генерируется, когда модаль создан видимым для пользователя (будет ждать CSSпереходы для завершения).
hide.bs.modal Это событие возникает сразу же, когда hide метод экземпляра уже был вызван.
hidden.bs.modal Это событие генерируется, когда модаль перестал быть скрытым от пользователя (будет ждать CSS переходы для завершения).
$('#myModal').on('hidden.bs.modal', function () {
  // do something…
})

Добавьте к выпадающему меню и больше ничего простой плагин, включающий в себя панель навигации, вкладки и таблетки.

В пределах навигатора

В пределах вкладки

Через аттрибутивные данные

Добавьте data-toggle="dropdown" к ссылке или кнопке, чтобы переключить выпадение.

<div class="dropdown">
  <a data-toggle="dropdown" href="#">Dropdown trigger</a>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

Сохранить URLs в неизменном состоянии, используйте data-target атрибут вместо href="#"..

<div class="dropdown">
  <a id="dLabel" role="button" data-toggle="dropdown" data-target="#" href="/page.html">
    Dropdown <span class="caret"></span>
  </a>
  <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

Через JavaScript

Вызовите выпадения через JavaScript:

$('.dropdown-toggle').dropdown()

Опции

Отсутствуют

Методы

$().dropdown('toggle')

Переключает в выпадающем меню данной панели навигации или вкладки навигации.

События

Вид события Описание
show.bs.dropdown Это событие возникает сразу же, как вызван метод экземпляра.
shown.bs.dropdown Этот событие возникает, когда выпадение было сделано видимым для пользователя (будет ждать CSS переходы для завершения).
hide.bs.dropdown Это событие возникает сразу же, как вызван скрытый метод экземпляра.
hidden.bs.dropdown Это событие возникает, когда выпадения перестали быть скрытыми от пользователя (будет ждать CSS переходы для завершения).
$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

Пример в навигаторе

Прокрутка-шпион плагина предназначена для автоматического обновления навигационных целей на основе позиции прокрутки. Прокрутите область ниже навигатора и увидите активное изменение класса. Выпадающих подпункты будут также выделены.

@fat

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.

@mdo

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.

one

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.

two

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.

three

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.

Использование

Через аттрибутивные данные

Чтобы легко добавить прокрутку слежения в вашу верхнюю панель навигации, добавьте data-spy="scroll"к элементу, за которым вы хотите проследить (как правило, это будет <body>). Затем добавьте data-target атрибута с ID или классом исходного элемента в Bootstrap .nav компонент.

<body data-spy="scroll" data-target="#navbar-example">
  ...
</body>

Через JavaScript

Вызовите прокрутку слежения через JavaScript:

$('body').scrollspy({ target: '#navbar-example' })

Разрешимые ID цели подразумевают

Навигационные ссылки должны иметь разрешимые ID цели. Например, <a href="#home">home</a> должен сопоставляться с DOM наподобие <div id="home"></div>..

Методы

.scrollspy('refresh')

Когда используете "скроллспай" в объединение с добавление или удалением элементов из ДОМа, вам нужно вызвать метод обновления как показано здесь:

$('[data-spy="scroll"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
})

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-offset=""

имя вид по умолчанию описание
Смещение номер 10 Пиксели, чтобы компенсировать сверху при расчете положения прокрутки.

События

Вид события Описание
activate.bs.scrollspy Это событие возникает всякий раз, когда новый элемент становится активированным с помощью прокрутки-шпиона.
$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Пример вкладок

Добавьте быструю, динамичную вкладку функциональности, чтобы осуществить переход через панель местного контента, даже с помощью выпадающего меню.

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.

Использование

Разрешите вкладочные вкладки с помощью JavaScript (каждая вкладка должна быть активирована индивидуально):

$('#myTab a').click(function (e) {
  e.preventDefault()
  $(this).tab('show')
})

Вы можете активировать индивидуальные вкладки несколькими путями:

$('#myTab a[href="#profile"]').tab('show') // Select tab by name
$('#myTab a:first').tab('show') // Select first tab
$('#myTab a:last').tab('show') // Select last tab
$('#myTab li:eq(2) a').tab('show') // Select third tab (0-indexed)

Разметка

Вы можете активировать вкладку или таблетку навигации без написания JavaScript, просто указав data-toggle="tab" или data-toggle="pill" на элементе. Добавление nav и nav-tabs классов к вкладке ul будет применять Bootstrap для стильного оформления вкладки.

<ul class="nav nav-tabs">
  <li><a href="#home" data-toggle="tab">Home</a></li>
  <li><a href="#profile" data-toggle="tab">Profile</a></li>
  <li><a href="#messages" data-toggle="tab">Messages</a></li>
  <li><a href="#settings" data-toggle="tab">Settings</a></li>
</ul>

Чтобы создать постепенное появление вкладок, добавьте .fade к каждому .tab-pane.

Методы

$().tab

Активизирует элемент вкладки и содержание контейнера. Вкладка должна быть либо data-target или href ориентации контейнера узла в DOM.

<ul class="nav nav-tabs" id="myTab">
  <li class="active"><a href="#home">Home</a></li>
  <li><a href="#profile">Profile</a></li>
  <li><a href="#messages">Messages</a></li>
  <li><a href="#settings">Settings</a></li>
</ul>

<div class="tab-content">
  <div class="tab-pane active" id="home">...</div>
  <div class="tab-pane" id="profile">...</div>
  <div class="tab-pane" id="messages">...</div>
  <div class="tab-pane" id="settings">...</div>
</div>

<script>
  $(function () {
    $('#myTab a:last').tab('show')
  })
</script>

События

Вид события Описание
show.bs.tab Это событие возникает во вкладке шоу, но только перед показом новой вкладки. Используйте event.target и event.relatedTarget, чтобы нацелить активную вкладку и предыдущую активную вкладку (если доступно) соответственно.
shown.bs.tab Это событие возникает во вкладке шоу, но только после показа новой вкладки. Используйте event.target и event.relatedTarget, чтобы нацелить активную вкладку и предыдущую активную вкладку (если доступно) соответственно.
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // activated tab
  e.relatedTarget // previous tab
})

Дополнительные шаблоны

Вдохновленное замечательным плагином JQuery.tipsy написанным Джейсоном Фреймом; "Подсказки" обновленная версия, которая не зависит от изображений, использует ЦСС3 для анимации, и дата-атрибуты для локального хранения заголовка.

Наведите курсор мыши на ссылку ниже, чтобы увидеть подсказки:

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.

Четыре направления

Всплывающие подсказки в кнопке группы и вводные группы требуют специальной настройки

Когда используют "подсказки" на элементах внутри .btn-group или .input-group, вам нужно указать опцию container: 'body' (описанную ниже) для того чтобы избежать нежелательных сторонних эффектов (таких как элемент становиться шире и/или лишается круглых уголков когда вызывается "подсказка").

Использование

Запустите всплывающую подсказку через JavaScript:

$('#example').tooltip(options)

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-animation=""

имя вид по умолчанию описание
анимация логический true применяет CSS исчезнувшего перехода к выпадающей подсказке
язык html логический false Вставить ХТМЛ код в подсказку. Если "ложь", jQuery метод text может быть использован для вставки контент в ДОМ. Используйте текст, если вас беспокоит XSS атаки.
размещение строка | функция 'top' как позиционировать всплывающие подсказки - наверх | вниз | налево | направо | автоматически.
При выборе "Авто", она будет динамично переориентирует подсказку. Например, если разместить как "авто налево, подсказка будет отображаться слева, когда это возможно, в противном случае оно будет отображаться правильно.
селектор строка false Если селектор предусмотрен, то подсказка объекта будут делегирована по указанным целям.
заголовок строка | функция '' изначальное значение заголовка если аттрибут title не указан
триггер строка 'hover focus' как подсказка запускается - кликните | курсор| фокус | руководство. Вы можете пропустить несколько триггеров, разделив их пробелом.
задержка номер | объект 0

задержка отображающей и скрытой подсказки (мс) - не относится к ручному типу триггера

Если номер предоставляется, задержка применяется к обеим функциям скрытия / отображения

Структура объекта это: delay: { show: 500, hide: 100 }

контейнер строка | ложное false

Присоединяет подсказку к конкретному элементу. Пример: container: 'body'

Данные атрибуты для отдельных всплывающих подсказок

Опции для отдельных подсказок могут альтернативно быть определены через использование атрибутивных данных, как описано выше.

Разметка

<a href="#" data-toggle="tooltip" title="first tooltip">Hover over me</a>

Методы

$().tooltip(options)

Прилагает обработчик подсказки к элементу коллекции.

.tooltip('show')

Показать подсказку на элементе.

$('#element').tooltip('show')

.tooltip('hide')

Спрятать подсказку на элементе.

$('#element').tooltip('hide')

.tooltip('toggle')

Показать подсказку на элементе.

$('#element').tooltip('toggle')

.tooltip('destroy')

Спрятать и удалить подсказку на элементе.

$('#element').tooltip('destroy')

События

Вид события Описание
show.bs.tooltip Это событие возникает сразу же, когда show метод экземпляра вызван.
shown.bs.tooltip Это событие возникает, когда выпадающая подсказка становится видимой для пользователя (будет ждать CSS переходы для завершения).
hide.bs.tooltip Это событие возникает сразу же, когда hide метод экземпляра уже был вызван.
hidden.bs.tooltip Это событие возникает, когда выпадающая подсказка перестала быть скрытой для пользователя (будет ждать CSS переходы для завершения).
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Дополнительные шаблоны

Добавьте небольшие наложения к содержанию, как на Ipad, к любому элементу для домашней вторичной информации.

Зависимость от плагина

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

Вспомогательные экраны в кнопке групп и вводных группах предусматривают специальные настройки

Когла используете "поповеры" на элементах внутри .btn-group или .input-group, вам нужно указать опцию container: 'body' (описанную ниже) для того чтобы избежать нежелательных сторонних эффектов (таких как элемент становиться шире и/или лишается круглых уголков когда вызывается "поповер").

Статичный вспомогательный экран

Доступны четыре опции: верхнее, правое, нижнее и левое выравнивание.

Popover top

Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover right

Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover bottom

Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover left

Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Живая демонстрация

Четыре направления

Использование

Отключить вспомогательные экраны с помощью JavaScript:

$('#example').popover(options)

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-animation=""

имя вид по умолчанию описание
анимация логический true применяет CSS исчезнувшего перехода к выпадающей подсказке
язык html логический false Вставки ХТМЛ кода внутри "поповера". Если "ложь" jQuery text может быть использован для вставки контент в ДОМ. Используйте текст, если вас беспокоит XSS атаки.
размещение строка | функция 'right' как позиционировать вспомогательный экран - наверх | вниз | налево | направо | автоматически.
При выборе "Авто", она динамично переориентирует экран. Например, если разместить как "авто налево, подсказка будет отображаться слева, когда это возможно, в противном случае оно будет отображаться правильно.
селектор строка false Если селектор предусмотрено, подсказка объектов будут делегирована по указанным целям, если селектор предусмотрено, подсказка объектов будут делегированы по указанным целям. На практике, это используется для выключения динамического HTML содержания, чтобы вспомогательные экраны были добавлены. Смотреть это и информативный пример.
триггер строка 'click' как запускается вспомогательные экран - клик | курсос | фокус | руководство
заголовок строка | функция '' изначальное значение заголовка если аттрибут title не указан
содержание строка | функция '' изначальное значение контента, если атрибут data-content не указан
задержка номер | объект 0

задержка отображающего и скрытого экрана (мс) - не относится к ручному типу триггера

Если номер предоставляется, задержка применяется к обеим функциям скрытия / отображения

Структура объекта это: delay: { show: 500, hide: 100 }

контейнер строка | ложное false

Добавляет "поповер" для указанного элемента. Пример: container: 'body'. Эта опция в некотором роде полезна в том что позволяет вам позиционировать "поповер" в потоке документа близ вызываемого элемента - который может предотвратить "поповер" от ухода от вызываемого элемента в тот момент когда окно изменяет пропорции.

Дата атрибутивов для индивидуальных вспомогательных экранов

Опции для индивидуальных "поперов" может быть также указана через использование дата атрибутов, как объяснено выше.

Разметка

По причинам производительности, подсказка и вспомогательный экран прикладных интерфейсов сопоставимы. Если вы хотите использовать их, просто укажите селектор опции.

Методы

$().popover(options)

Запускает вспомогательные экраны для элемента коллекции.

.popover('show')

Показывает элементы вспомогательного экрана.

$('#element').popover('show')

.popover('hide')

Скрывает элементы вспомогательного экрана.

$('#element').popover('hide')

.popover('toggle')

Переключает элементы вспомогательного экрана.

$('#element').popover('toggle')

.popover('destroy')

Скрывает и удаляет "поповер" с элемента.

$('#element').popover('destroy')

События

Вид события Описание
show.bs.popover Это событие возникает сразу же, когда show метод экземпляра вызван.
shown.bs.popover Это событие возникает, когда вспомогательный экран становится видимым для пользователя (будет ждать CSS переходы для завершения).
hide.bs.popover Это событие возникает сразу же, когда hide метод экземпляра уже был вызван.
hidden.bs.popover Это событие возникает, когда вспомогательный экран перестал быть скрытым для пользователя (будет ждать CSS переходы для завершения).
$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Пример оповещения

Добавить "отменяющий" функционал для всех сообщений о предупреждение с этим плагином.

Holy guacamole! Best check yo self, you're not looking too good.

Oh snap! You got an error!

Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

Take this action Or do this

Использование

Отключить отклонение оповещения через JavaScript:

$(".alert").alert()

Разметка

Просто добавьте data-dismiss="alert" к вашей закрытой кнопке для автоматического оповещения завершения функциональности.

<a class="close" data-dismiss="alert" href="#" aria-hidden="true">&times;</a>

Методы

$().alert()

Преобразуйте все оповещения с помощью закрытия функциональности. Для того, чтобы запустить свои оповещения, когда они закрыты, убедитесь, что они имеют .fade и .in классы уже примененные к ним.

.alert('close')

Закрывает все оповещения.

$(".alert").alert('close')

События

Bootstrap класс "сообщений о предупреждение" показывает несколько событий для привязки к функционалу "предупреждений".

Вид события Описание
close.bs.alert Это событие возникает сразу же, когда close метод экземпляра вызван.
closed.bs.alert Это событие вызывается когда уведомление было закрыто (будет ждать для CSS переходов для завершения).
$('#my-alert').bind('closed.bs.alert', function () {
  // do something…
})

Пример использования

Работайте больше с кнопками. Кнопка управления устанавливает или создает группы кнопок для большего использования компонентов, таких как панели инструментов.

Установочный

Добавьте data-loading-text="Loading..." для использования загрузочной установки на кнопке.

<button type="button" data-loading-text="Loading..." class="btn btn-primary">
  Loading state
</button>

Единичное переключение

Добавьте data-toggle="button", чтобы активизировать переключение на единичной кнопке.

<button type="button" class="btn btn-primary" data-toggle="button">Single toggle</button>

Флажок

Добавьте data-toggle="buttons" к группе флажков, чтобы стиль флажка переключился на группу кнопок.

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary">
    <input type="checkbox"> Option 1
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Option 2
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Option 3
  </label>
</div>

Радио

Добавьте data-toggle="buttons" к группе радио вводов, чтобы радио стиль переключился на группу кнопок.

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option1"> Option 1
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option2"> Option 2
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option3"> Option 3
  </label>
</div>

Использование

Отключение кнопок через JavaScript:

$('.nav-tabs').button()

Разметка

Данные атрибутов являются неотъемлемой частью кнопки плагина. Проверьте на примере кода ниже для различных видов разметки.

Опции

Отсутствуют

Методы

$().button('toggle')

Переключает состояние нажатия. Дает кнопке впечатление, что он был активирован.

Авто переключение

Вы можете отключить авто переключение кнопки путем использования data-toggle атрибута.

<button type="button" class="btn" data-toggle="button">...</button>

$().button('loading')

Устанавливает состояние кнопки для загрузки - отключает кнопку и подготавливает текст к загрузке текста. Загрузка текста должна быть определена на кнопке элемента с помощью атрибута данных data-loading-text.

<button type="button" class="btn" data-loading-text="loading stuff...">...</button>

Совместимость кроссбраузерности

Firefox сохраняется в отключенном состоянии при загрузке страницы. Обойти это можно, используя autocomplete="off".

$().button('reset')

Сбрасывает состояние кнопки - преобразовывает текст в оригинальный текст.

$().button(string)

Сбрасывает состояние кнопки - преобразовывает текст в данные, определенные текстовым состоянием.

<button type="button" class="btn" data-complete-text="finished!" >...</button>
<script>
  $('.btn').button('complete')
</script>

Об этом

Получить базу стилей и гибкую поддержку компонентов для свернутых компонентов, похожих на гармошку и навигации.

Зависимость от плагина

Сворачивание подразумевает что переходы плагина включен в вашу версию Bootstrap.

Пример гармошки

Используя сворачивание плагина, мы строим простую гармошку путем расширения панели компонента.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
<div class="panel-group" id="accordion">
  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion" href="#collapseOne">
          Collapsible Group Item #1
        </a>
      </h4>
    </div>
    <div id="collapseOne" class="panel-collapse collapse in">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">
          Collapsible Group Item #2
        </a>
      </h4>
    </div>
    <div id="collapseTwo" class="panel-collapse collapse">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion" href="#collapseThree">
          Collapsible Group Item #3
        </a>
      </h4>
    </div>
    <div id="collapseThree" class="panel-collapse collapse">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
</div>

Вы также может использовать плагин без стилей "аккордиона". Сделайте кнопку вызывающую раскрытие и свертывание другого элемента.

<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
  simple collapsible
</button>

<div id="demo" class="collapse in">...</div>

Использование

Через аттрибутивные данные

Просто добавьте data-toggle="collapse" и аdata-target на элемент для автоматического присваивания контроля над сворачиваемым элементом. Атрибут data-target принимает CSS селектор для сворачивания. Будьте уверены что добавляете класс collapse на сворачиваемый элемент. Если вам нравиться держать элемент открытым по умолчанию, добавьте дополнительный класс in.

Чтобы добавить гармошкообразную группу управления к сворачиванию, добавьте данные атрибута data-parent="#selector". Обратитесь к демо, чтобы увидеть это в действии.

Через JavaScript

Включить вручную с:

$(".collapse").collapse()

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-parent=""

имя вид по умолчанию описание
источник селектор false Если селектор, тогда все сворачиваемые элементы под указанным источником будут закрыты. (по аналогии с традиционным поведением гармошки - это зависит от accordion-group класса)
переключатель логический true Переключает свернутый элемент на вызов.

Методы

.collapse(options)

Активирует ваше содержание в виде свернутого элемента. Принимает дополнительные опции object.

$('#myCollapsible').collapse({
  toggle: false
})

.collapse('toggle')

Переключает складной элемент на показанный или скрытый.

.collapse('show')

Показывает элемент коллапса.

.collapse('hide')

Скрывает элемент коллапса.

События

Bootstrap "складывающиеся" класс показывающий несколько событий которые можно привязать к функционалу.

Вид события Описание
show.bs.collapse Это событие возникает сразу же, когда show метод экземпляра вызван.
shown.bs.collapse Это событие вызывается когда элемент коллапса был сделан видимым для пользователя (будет ждать для CSS переходов для завершения).
hide.bs.collapse Это событие вызывается немедленно когда hide метод был вызван.
hidden.bs.collapse Это событие вызывается когда элемент коллапса был скрыт от пользователя (будет ждать CSS переходов для завершения).
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Слайд-шоу ниже показывает общий плагин и компонент для вращения с помощью элементов, как карусель.

<div id="carousel-example-generic" class="carousel slide">
  <!-- Indicators -->
  <ol class="carousel-indicators">
    <li data-target="#carousel-example-generic" data-slide-to="0" class="active"></li>
    <li data-target="#carousel-example-generic" data-slide-to="1"></li>
    <li data-target="#carousel-example-generic" data-slide-to="2"></li>
  </ol>

  <!-- Wrapper for slides -->
  <div class="carousel-inner">
    <div class="item active">
      <img src="..." alt="...">
      <div class="carousel-caption">
        ...
      </div>
    </div>
    ...
  </div>

  <!-- Controls -->
  <a class="left carousel-control" href="#carousel-example-generic" data-slide="prev">
    <span class="icon-prev"></span>
  </a>
  <a class="right carousel-control" href="#carousel-example-generic" data-slide="next">
    <span class="icon-next"></span>
  </a>
</div>

Альтернативы Glyphicon

С Glyphicons доступом, вы можете выбрать стиль левой и правой кнопок для вызова с .glyphicon .glyphicon-chevron-left и .glyphicon .glyphicon-chevron-right.

Дополнительные надписи

Добавить надписи для Ваших слайдов можно легко с помощью .carousel-caption элемента в пределах любого .item. Наведите практически любой дополнительный HTML там, и он будет автоматически выровнен и отформатирован.

<div class="item active">
  <img src="..." alt="...">
  <div class="carousel-caption">
    <h3>...</h3>
    <p>...</p>
  </div>
</div>

Вопрос доступа

Компонент карусели, как правило, не соответствует стандартам общедоступности. Если Вам нужно, чтобы он был совместим, можете рассмотреть другие варианты для представления Вашего содержания.

Через аттрибутивные данные

Используйте данные атрибутов, чтобы легко контролировать положение карусели. data-slide принимает ключевые слова prev или next, которые меняют скольжение положения карусели относительно к ее настоящему месту. Вместо этого также можете использовать data-slide-to для прохождения необработанного показателя скольжения к карусели , которая перемещает скольжение к конкретному показателю начиная с 0.

Через JavaScript

Назовите карусель вручную с:

$('.carousel').carousel()

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-interval=""

имя вид по умолчанию описание
интервал номер 5000 Количество времени, которое задерживает автоматическое вращение элемента. Если выходит ошибка, карусель не будет автоматически вращаться.
пауза строка "hover" Останавливает вращение карусели на mouseenter и восстанавливает круговорот на mouseleave.
обертка логический true Когда карусель должна вращаться беспрерывно или иметь жесткие остановки.

Методы

.carousel(options)

Инициирует карусель с дополнительными опциями object и начинает вращаться с помощью элементов.

$('.carousel').carousel({
  interval: 2000
})

.carousel('cycle')

Вращает с помощью элементов карусели слева направо.

.carousel('pause')

Останавливает карусель вращаться с помощью элементов.

.carousel(number)

Вращает карусель к конкретной рамке (начиная с 0, похоже на матрицу)

.carousel('prev')

Вращает к предыдущему элементу.

.carousel('next')

Вращает к следующему элементу.

События

Bootstrap карусель класс показывает два события для привязки к функционалу карусели.

Вид события Описание
slide.bs.carousel Это событие срабатывает сразу когда slide вызывается примерный метод .
slid.bs.carousel Это событие срабатывает когда карусель завершила свою смену сладов.
$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Пример

Поднавигация слева является живым демо affix плагина.


Использование

Через аттрибутивные данные

Чтобы легко добавлять affix поведение к любому элементу, просто добавьте data-spy="affix" к элементу, за которым Вы хотите шпионить. Затем используйте смещение для определения когда переключить закрепление элементов.

<div data-spy="affix" data-offset-top="200">...</div>

Требуется независимое моделирование

Аффикс вызывается между тремя состояниями/классами: affix,affix-top, и affix-bottom. Вы должны предоставить стили для этих классов самостоятельно (независимо от этого плагина). affix-top класс должен быть в текущем потоке документа. affix класс должен быть фиксирован к странице. И affix-bottom должен абсолютно позиционирован. Заметьте что, affix-bottom это специальный код в том плагине который поставит элемент в джаваскрипте относительно опции offset: { bottom: number } которую вы должны указать.

Через JavaScript

Назовите affix плагин с помощью JavaScript

$('#myAffix').affix({
  offset: {
    top: 100
    , bottom: function () {
      return (this.bottom = $('.bs-footer').outerHeight(true))
    }
  }
})

Опции

Опции могут быть переданы с помощью атрибутивных данных или JavaScript. Для атрибутивных данных, добавьте опцию имя к data-, также как и к data-offset-top="200"

имя вид по умолчанию описание
Смещение число | функция | цель 10 Пиксели для смещения с экрана при расчете положения прокрутки. Если предоставлен один номер, то смещение будет применяться и в верхнем и нижнем направлениях. Чтобы обеспечить уникальное, нижнее и верхнее смещение нужно просто применить объект offset: { top: 10 } или offset: { top: 10, bottom: 5 }. Используйте функцию когда Вам нужно динамично вычислить смещение.