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 с помощью атрибута данных.

Пример

<div class="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-default" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="left" data-content="Некоторое содержимое в левом Popover">Popover слева</button> <button type="button" class="btn btn-primary" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="top" data-content="Некоторое содержимое в верхнем Popover">Popover сверху</button> <button type="button" class="btn btn-success" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Некоторое содержимое в нижнем Popover">Popover снизу</button> <button type="button" class="btn btn-warning" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="right" data-content="Некоторое содержимое в правом Popover">Popover справа</button> </div> <script>
$(function (){ $("[data-toggle='popover']").popover(); });
</script> </div>

Попробуйте »

Результат показан ниже:

弹出框(Popover)插件

Параметры

Есть несколько опций, добавляемых через Bootstrap Data API или вызываемых через JavaScript. В следующей таблице перечислены эти опции:

Название параметраТип/Значение по умолчаниюИмя атрибута данныхОписание
animationлогическое значение
Значение по умолчанию: true
data-animationПрименяет CSS-переход с эффектом затухания к поповеру.
htmlлогическое значение
Значение по умолчанию: false
data-htmlВставляет HTML в поповер. Если false, для вставки содержимого в DOM будет использоваться метод text из jQuery. Если вы обеспокоены XSS-атаками, используйте text.
placementstring|function
Значение по умолчанию: top
data-placementУказывает, как расположить поповер (т.е. top|bottom|left|right|auto).
Если установлено вauto, поповер будет динамически скорректирован. Например, если placement равен "auto left", поповер будет отображаться как можно левее, и показываться справа только если обстоятельства не позволяют.
selectorstring
Значение по умолчанию: false
data-selectorЕсли указан селектор, объекты popover будут делегированы указанным целям.
titlestring | function
Значение по умолчанию: ''
data-titleЕсли атрибутtitleне указан, то опция title является значением заголовка по умолчанию.
triggerstring
Значение по умолчанию: '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:

Пример

<div class="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-default popover-show" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="left" data-content="Некоторое содержимое во всплывающем окне слева — метод show">Всплывающее окно слева</button> <button type="button" class="btn btn-primary popover-hide" title="Заголовок всплывающего окна" data-container="body" data-toggle="popover" data-placement="top" data-content="Некоторое содержимое во всплывающем окне вверху — метод hide">Всплывающее окно вверху</button> <button type="button" class="btn btn-success popover-destroy" title="Заголовок Popover" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Некоторое содержимое во всплывающем окне внизу — метод destroy">Всплывающее окно внизу</button> <button type="button" class="btn btn-warning popover-toggle" title="Заголовок всплывающего окна" data-container="body" data-toggle="popover" data-placement="right" data-content="Некоторое содержимое во всплывающем окне справа — метод toggle">Всплывающее окно справа</button><br><br><br><br><br><br> <p class="popover-options"> <a href="#" type="button" class="btn btn-warning" title="<h2>Заголовок</h2>" data-container="body" data-toggle="popover" data-content="<h4>Некоторое содержимое во всплывающем окне — метод options</h4>"> Popover </a> </p> <скрипт>
$(функция () { $('.popover-show').popover('show');}); $(функция () { $('.popover-hide').popover('hide');}); $(функция () { $('.popover-destroy').popover('destroy');}); $(функция () { $('.popover-toggle').popover('toggle');}); $(функция () { $(".popover-options a").popover({html : true });});
</script> </div>

Попробуйте »

Результат следующий:

弹出框(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:

Пример

<div clas="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-primary popover-show" title="Заголовок Popover" data-container="body" data-toggle="popover" data-content="Некоторое содержимое в Popover слева — метод show">Popover слева</button> </div> <script>
$(функция () { $('.popover-show').popover('show');}); $(функция () { $('.popover-show').on('shown.bs.popover', function () { alert("Сообщение оповещения при показе"); }) });
</script> </div>

Попробуйте »

Результат следующий:

弹出框(Popover)插件事件
Другие расширения