Учебники

Bootstrap — Popover Плагин

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

Если вы хотите включить эту функциональность плагина индивидуально, то вам понадобится popover.js, и он зависит от плагина всплывающей подсказки . Иначе, как упоминалось в главе « Обзор плагинов Bootstrap» , вы можете включить bootstrap.js или минимизированный bootstrap.min.js .

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

Плагин popover генерирует контент и разметку по требованию и по умолчанию размещает popover после своего триггерного элемента. Вы можете добавить popover следующими двумя способами:

  • Через атрибуты данных — чтобы добавить поповер, добавьте data-toggle = «popover» к тегу привязки / кнопки. Название якоря будет текстом всплывающего окна. По умолчанию всплывающее окно установлено плагином наверх.

Через атрибуты данных — чтобы добавить поповер, добавьте data-toggle = «popover» к тегу привязки / кнопки. Название якоря будет текстом всплывающего окна. По умолчанию всплывающее окно установлено плагином наверх.

<a href = "#" data-toggle = "popover" title = "Example popover">
   Hover over me
</a>
  • Через JavaScript — включить всплывающие окна через JavaScript, используя следующий синтаксис —

Через JavaScript — включить всплывающие окна через JavaScript, используя следующий синтаксис —

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

Плагин Popover — это НЕ ТОЛЬКО плагины css, такие как dropdown или другие плагины, которые обсуждались в предыдущих главах. Чтобы использовать этот плагин, вы ДОЛЖНЫ активировать его с помощью jquery (читайте javascript). Чтобы включить все всплывающие окна на вашей странице, просто используйте этот скрипт —

$(function () { $("[data-toggle = 'popover']").popover(); });

Плагин Popover — это НЕ ТОЛЬКО плагины css, такие как dropdown или другие плагины, которые обсуждались в предыдущих главах. Чтобы использовать этот плагин, вы ДОЛЖНЫ активировать его с помощью jquery (читайте javascript). Чтобы включить все всплывающие окна на вашей странице, просто используйте этот скрипт —

пример

В следующем примере демонстрируется использование плагина popover через атрибуты данных.

<div class = "container" style = "padding: 100px 50px 10px;" >
   <button type = "button" class = "btn btn-default" title = "Popover title"  
      data-container = "body" data-toggle = "popover" data-placement = "left" 
      data-content = "Some content in Popover on left">
      
      Popover on left
   </button>
   
   <button type = "button" class = "btn btn-primary" title = "Popover title"  
      data-container = "body" data-toggle = "popover" data-placement = "top" 
      data-content = "Some content in Popover on top">
      
      Popover on top
   </button>
   
   <button type = "button" class = "btn btn-success" title = "Popover title"  
      data-container = "body" data-toggle = "popover" data-placement = "bottom" 
      data-content = "Some content in Popover on bottom">
      
      Popover on bottom
   </button>
   
   <button type = "button" class = "btn btn-warning" title = "Popover title"  
      data-container = "body" data-toggle = "popover" data-placement = "right" 
      data-content = "Some content in Popover on right">
      
      Popover on right
   </button>
   
</div>

<script>
   $(function (){
      $("[data-toggle = 'popover']").popover();
   });
</script>

Опции

Существуют определенные параметры, которые можно добавить с помощью API данных Bootstrap или вызвать с помощью JavaScript. В следующей таблице перечислены параметры —

Название варианта Тип / Значение по умолчанию Имя атрибута данных Описание
анимация логическое значение по умолчанию — true данные анимация Применяет CSS-переход с постепенным исчезновением к поповеру.
HTML логическое значение по умолчанию — false данных HTML Вставляет HTML в поповер. Если false, текстовый метод jQuery будет использоваться для вставки содержимого в dom. Используйте текст, если вы беспокоитесь о XSS-атаках.
размещение строка | функция По умолчанию — верх данные размещение Определяет, как позиционировать всплывающее окно (т. Е. Top | bottom | left | right | auto).

Если задано значение auto , оно динамически переориентирует всплывающее окно. Например, если для размещения выбрано «auto left», поповер будет отображаться слева, когда это возможно, в противном случае он будет отображаться справа.

селектор строка По умолчанию — false Данные селекторы Если предоставляется селектор, поповерные объекты будут делегированы указанным целям.
заглавие строка | Функция по умолчанию — « данных в заголовке Параметр title является значением заголовка по умолчанию, если атрибут title отсутствует.
спусковой крючок Строка По умолчанию — «Наведение фокуса» данные триггер Определяет, как срабатывает поповер — нажмите | парить | фокус | ручной . Вы можете передать несколько триггеров; разделите их пробелом.
задержка номер | Объект по умолчанию — 0 Данные задержки

Задержки, показывающие и скрывающие попсовер в мс — не относится к типу ручного запуска. Если указан номер, задержка применяется как к скрытию / показу. Структура объекта —

delay: { show: 500, hide: 100 }
контейнер строка | false По умолчанию — false Данные-контейнер Добавляет поповер к определенному элементу. Пример: контейнер: ‘тело’

Если задано значение auto , оно динамически переориентирует всплывающее окно. Например, если для размещения выбрано «auto left», поповер будет отображаться слева, когда это возможно, в противном случае он будет отображаться справа.

Задержки, показывающие и скрывающие попсовер в мс — не относится к типу ручного запуска. Если указан номер, задержка применяется как к скрытию / показу. Структура объекта —

методы

Ниже приведены некоторые полезные методы для popover —

метод Описание пример

Опции — .popover (опции)

Присоединяет обработчик всплывающих окон к коллекции элементов.
$().popover(options)

Toggle — .popover (‘toggle’)

Переключает элемент поповера.
$('#element').popover('toggle')

Показать — .popover (‘показать’)

Показывает поповер элемента.
$('#element').popover('show')

Скрыть — .popover («скрыть»)

Скрывает поповер элемента.
$('#element').popover('hide')

Уничтожить — .popover (‘уничтожить’)

Скрывает и уничтожает поповер элемента.
$('#element').popover('destroy')

Опции — .popover (опции)

Toggle — .popover (‘toggle’)

Показать — .popover (‘показать’)

Скрыть — .popover («скрыть»)

Уничтожить — .popover (‘уничтожить’)

пример

В следующем примере демонстрируются методы плагина popover —

<div class = "container" style = "padding: 100px 50px 10px;" >
   <button type = "button" class = "btn btn-default popover-show" 
      title = "Popover title" data-container = "body" 
      data-toggle = "popover" data-placement = "left" 
      data-content = "Some content in Popover with show method">
      
      Popover on left
   </button>
   
   <button type = "button" class = "btn btn-primary popover-hide" 
      title = "Popover title" data-container = "body" 
      data-toggle = "popover" data-placement = "top" 
      data-content = "Some content in Popover-hide method">
      
      Popover on top
   </button>
   
   <button type = "button" class = "btn btn-success popover-destroy" 
      title = "Popover title" data-container = "body" 
      data-toggle = "popover" data-placement = "bottom" 
      data-content = "Some content in Popover-destroy method">
      
      Popover on bottom
   </button>
   
   <button type = "button" class = "btn btn-warning popover-toggle" 
      title = "Popover title" data-container = "body" 
      data-toggle = "popover" data-placement = "top" 
      data-content = "Some content in Popover-toggle method">
      
      Popover on right
   </button>
	
   <br><br><br><br><br><br>
   
   <p class = "popover-options">
      <a href = "#" type = "button" class = "btn btn-warning" 
         title = "<h2>Title</h2>" data-container = "body" 
         data-toggle = "popover" data-content = "
         <h4>Some content in Popover-options method</h4>">
         
         Popover
      </a>
   </p>
   
   <script>
      $(function () { $('.popover-show').popover('show');});
      $(function () { $('.popover-hide').popover('hide');});
      $(function () { $('.popover-destroy').popover('destroy');});
      $(function () { $('.popover-toggle').popover('toggle');});
      $(function () { $(".popover-options a").popover({html : true });});
   </script>
	
</div>

События

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

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

пример

В следующем примере демонстрируются события плагина Popover —