Bootstrap Плагин Popover
Плагин Popover похож на Tooltip; он предоставляет расширенное представление. Чтобы активировать popover, пользователю достаточно навести курсор мыши на элемент. Содержимое popover можно полностью заполнить с помощью Bootstrap Data API. Этот метод зависит от плагина Tooltip.
Если вы хотите включить функциональность этого плагина отдельно, вам нужно подключитьpopover.js, который зависит отплагина Tooltip. Или, какглава обзора плагинов Bootstrapупоминает, вы можете подключитьbootstrap.jsили минифицированную версиюbootstrap.min.js。
Использование
Плагин Popover генерирует содержимое и разметку по требованию. По умолчанию Popover размещается после элемента, который его вызывает. Вы можете добавить Popover следующими двумя способами:
- С помощью атрибутов данных: Чтобы добавить Popover, просто добавьтеdata-toggle="popover"к тегу якоря/кнопки. Заголовок якоря — это текст Popover. По умолчанию плагин размещает Popover сверху.
<a href="../index.html" data-toggle="popover" title="Example popover"> 请悬停在我的上面 </a>
- Через JavaScript:Включите Popover с помощью JavaScript:
$('#identifier').popover(options)
Плагин Popover не является чистым CSS-плагином, в отличие от выпадающих списков и других плагинов, рассмотренных ранее. Чтобы использовать этот плагин, вы должны активировать его с помощью jQuery (см. JavaScript). Используйте следующий скрипт, чтобы включить все Popover на странице:
$(function () { $("[data-toggle='popover']").popover(); });
Пример
В следующем примере демонстрируется использование плагина Popover с помощью атрибута данных.
Пример
Попробуйте »
Результат показан ниже:
Параметры
Есть несколько опций, добавляемых через Bootstrap Data API или вызываемых через JavaScript. В следующей таблице перечислены эти опции:
| Название параметра | Тип/Значение по умолчанию | Имя атрибута данных | Описание |
|---|---|---|---|
| animation | логическое значение Значение по умолчанию: true | data-animation | Применяет CSS-переход с эффектом затухания к поповеру. |
| html | логическое значение Значение по умолчанию: false | data-html | Вставляет HTML в поповер. Если false, для вставки содержимого в DOM будет использоваться метод text из jQuery. Если вы обеспокоены XSS-атаками, используйте text. |
| placement | string|function Значение по умолчанию: top | data-placement | Указывает, как расположить поповер (т.е. top|bottom|left|right|auto). Если установлено вauto, поповер будет динамически скорректирован. Например, если placement равен "auto left", поповер будет отображаться как можно левее, и показываться справа только если обстоятельства не позволяют. |
| selector | string Значение по умолчанию: false | data-selector | Если указан селектор, объекты popover будут делегированы указанным целям. |
| title | string | function Значение по умолчанию: '' | data-title | Если атрибутtitleне указан, то опция title является значением заголовка по умолчанию. |
| trigger | string Значение по умолчанию: 'hover focus' | data-trigger | Определяет, как срабатывает popover: click| hover | focus | manualМожно передать несколько триггеров, разделённых пробелами. |
| delay | число | объект Значение по умолчанию: 0 | data-delay | Количество миллисекунд для задержки показа и скрытия popover - не применимо к типу ручного триггера. Если указано число, задержка будет применяться как к показу, так и к скрытию. Если указан объект, структура следующая:
delay:
{ show: 500, hide: 100 } |
| container | строка | false Значение по умолчанию: false | data-container | Добавьте popover к указанному элементу. Пример: container: 'body' |
Методы
Ниже приведены некоторые полезные методы в плагине Popover:
| Метод | Описание | Пример |
|---|---|---|
| Параметры: .popover(options) | Прикрепите дескриптор popover к коллекции элементов. |
$().popover(options) |
| Переключение: .popover('toggle') | Переключить показ/скрытие всплывающего окна элемента. |
$('#element').popover('toggle')
|
| Показать: .popover('show') | Показать всплывающее окно элемента. |
$('#element').popover('show')
|
| Скрыть: .popover('hide') | Скрыть всплывающее окно элемента. |
$('#element').popover('hide')
|
| Уничтожить: .popover('destroy') | Скрыть и уничтожить всплывающее окно элемента. |
$('#element').popover('destroy')
|
Пример
В следующем примере демонстрируются методы плагина Popover:
Пример
Попробуйте »
Результат следующий:
Events
В следующей таблице перечислены события, используемые в плагине Popover. Эти события можно использовать как хуки в функциях.
| Event | Описание | Пример |
|---|---|---|
| show.bs.popover | Это событие срабатывает немедленно при вызове метода show экземпляра. |
$('#mypopover').on('show.bs.popover', function () {
// 执行一些动作...
})
|
| shown.bs.popover | Это событие срабатывает, когда Popover становится видимым пользователю (оно дождётся завершения CSS-перехода). |
$('#mypopover').on('shown.bs.popover', function () {
// 执行一些动作...
})
|
| hide.bs.popover | Это событие срабатывает сразу при вызове метода экземпляра hide. |
$('#mypopover').on('hide.bs.popover', function () {
// 执行一些动作...
})
|
| hidden.bs.popover | Это событие срабатывает, когда Popover скрывается от пользователя (оно дождётся завершения CSS-перехода). |
$('#mypopover').on('hidden.bs.popover', function () {
// 执行一些动作...
})
|
Пример
Следующий пример демонстрирует события плагина Popover:
Пример
Попробуйте »
Результат следующий: