Всплывающие подсказки полезны, когда вам нужно описать ссылку. Плагин был вдохновлен плагином jQuery.tipsy, написанным Джейсоном Фреймом . С тех пор всплывающие подсказки были обновлены для работы без изображений, анимации с помощью CSS-анимации и атрибутов данных для локального хранения заголовков.
Если вы хотите включить функциональность этого плагина индивидуально, вам понадобится tooltip.js . Иначе, как упоминалось в главе « Обзор плагинов Bootstrap» , вы можете включить bootstrap.js или минимизированный bootstrap.min.js .
использование
Плагин всплывающей подсказки генерирует контент и разметку по требованию и по умолчанию размещает всплывающие подсказки после элемента триггера. Вы можете добавить всплывающие подсказки следующими двумя способами:
-
Через атрибуты данных — чтобы добавить всплывающую подсказку, добавьте data-toggle = «tooltip» к тегу привязки. Название якоря будет текстом всплывающей подсказки. По умолчанию всплывающая подсказка устанавливается на верхнюю часть плагином.
Через атрибуты данных — чтобы добавить всплывающую подсказку, добавьте data-toggle = «tooltip» к тегу привязки. Название якоря будет текстом всплывающей подсказки. По умолчанию всплывающая подсказка устанавливается на верхнюю часть плагином.
<a href = "#" data-toggle = "tooltip" title = "Example tooltip">Hover over me</a>
-
С помощью JavaScript — вызвать всплывающую подсказку с помощью JavaScript —
С помощью JavaScript — вызвать всплывающую подсказку с помощью JavaScript —
$('#identifier').tooltip(options)
Плагин всплывающей подсказки — это НЕ только плагины css, такие как выпадающий список или другие плагины, которые обсуждались в предыдущих главах. Чтобы использовать этот плагин, вы ДОЛЖНЫ активировать его с помощью jquery (читайте javascript). Чтобы включить все всплывающие подсказки на вашей странице, просто используйте этот скрипт —
$(function () { $("[data-toggle = 'tooltip']").tooltip(); });
Плагин всплывающей подсказки — это НЕ только плагины css, такие как выпадающий список или другие плагины, которые обсуждались в предыдущих главах. Чтобы использовать этот плагин, вы ДОЛЖНЫ активировать его с помощью jquery (читайте javascript). Чтобы включить все всплывающие подсказки на вашей странице, просто используйте этот скрипт —
пример
В следующем примере демонстрируется использование плагина всплывающей подсказки через атрибуты данных.
<h4>Tooltip examples for anchors</h4> This is a <a href = "#" class = "tooltip-test" data-toggle = "tooltip" title = "Tooltip on left"> Default Tooltip</a>. This is a <a href = "#" class = "tooltip-test" data-toggle = "tooltip" data-placement = "left" title = "Tooltip on left">Tooltip on Left</a>. This is a <a href = "#" data-toggle = "tooltip" data-placement = "top" title = "Tooltip on top">Tooltip on Top</a>. This is a <a href = "#" data-toggle = "tooltip" data-placement = "bottom" title = "Tooltip on bottom">Tooltip on Bottom</a>. This is a <a href = "#" data-toggle = "tooltip" data-placement = "right" title = "Tooltip on right">Tooltip on Right</a> <br> <h4>Tooltip examples for buttons</h4> <button type = "button" class = "btn btn-default" data-toggle = "tooltip" title = "Tooltip on left"> Default Tooltip </button> <button type = "button" class = "btn btn-default" data-toggle = "tooltip" data-placement = "left" title = "Tooltip on left"> Tooltip on left </button> <button type = "button" class = "btn btn-default" data-toggle = "tooltip" data-placement = "top" title = "Tooltip on top"> Tooltip on top </button> <button type = "button" class = "btn btn-default" data-toggle = "tooltip" data-placement = "bottom" title = "Tooltip on bottom"> Tooltip on bottom </button> <button type = " button" class = " btn btn-default" data-toggle = "tooltip" data-placement = "right" title = "Tooltip on right"> Tooltip on right </button> <script> $(function () { $("[data-toggle = 'tooltip']").tooltip(); }); </script>
Опции
Существуют определенные параметры, которые можно добавить с помощью API данных Bootstrap или вызвать с помощью JavaScript. В следующей таблице перечислены параметры —
Название варианта | Тип / Значение по умолчанию | Имя атрибута данных | Описание |
---|---|---|---|
анимация | логическое значение по умолчанию: true | данные анимация | Применяет переход CSS-перехода к подсказке. |
HTML | логическое значение по умолчанию: false | данных HTML | Вставляет HTML во всплывающую подсказку. Если false, текстовый метод jQuery будет использоваться для вставки содержимого в dom. Используйте текст, если вы беспокоитесь о XSS-атаках. |
размещение | string | function По умолчанию: top | данные размещение |
Определяет, как расположить всплывающую подсказку (т. Е. Top | bottom | left | right | auto). Если задано значение auto , оно будет динамически переориентировать всплывающую подсказку. Например, если для размещения выбрано «auto left», всплывающая подсказка будет отображаться слева, когда это возможно, в противном случае она будет отображаться справа. |
селектор | строка По умолчанию: false | Данные селекторы | Если предоставляется селектор, объекты всплывающей подсказки будут делегированы указанным целям. |
заглавие | строка | Функция по умолчанию: « | данных в заголовке | Параметр title является значением заголовка по умолчанию, если атрибут title отсутствует. |
спусковой крючок | По умолчанию: «hover focus» | данные триггер | Определяет, как всплывающая подсказка срабатывает: нажмите | парить | фокус | ручной . Вы можете передать несколько триггеров; разделите их пробелом. |
содержание | строка | Функция по умолчанию: » | данных содержимого | Значение содержимого по умолчанию, если атрибут data-content отсутствует |
задержка | номер | По умолчанию: 0 | Данные задержки |
Задержки отображения и скрытия всплывающей подсказки в мс — не относится к типу ручного запуска. Если указан номер, задержка применяется как к скрытию / показу. Структура объекта — delay: { show: 500, hide: 100 } |
контейнер | строка | false По умолчанию: false | Данные-контейнер | Добавляет всплывающую подсказку к определенному элементу. Пример: контейнер: ‘тело’ |
Определяет, как расположить всплывающую подсказку (т. Е. Top | bottom | left | right | auto).
Если задано значение auto , оно будет динамически переориентировать всплывающую подсказку. Например, если для размещения выбрано «auto left», всплывающая подсказка будет отображаться слева, когда это возможно, в противном случае она будет отображаться справа.
Задержки отображения и скрытия всплывающей подсказки в мс — не относится к типу ручного запуска. Если указан номер, задержка применяется как к скрытию / показу. Структура объекта —
методы
Ниже приведены некоторые полезные методы для подсказок:
метод | Описание | пример |
---|---|---|
Опции — .tooltip (опции) |
Присоединяет обработчик всплывающей подсказки к коллекции элементов. |
$().tooltip(options) |
Toggle — .tooltip (‘toggle’) |
Переключение всплывающей подсказки элемента. |
$('#element').tooltip('toggle') |
Show — .tooltip (‘показать’) |
Показывает подсказку элемента. |
$('#element').tooltip('show') |
Скрыть — .tooltip («скрыть») |
Скрывает подсказку элемента. |
$('#element').tooltip('hide') |
Уничтожить — .tooltip (‘уничтожить’) |
Скрывает и уничтожает всплывающую подсказку элемента. |
$('#element').tooltip('destroy') |
Опции — .tooltip (опции)
Toggle — .tooltip (‘toggle’)
Show — .tooltip (‘показать’)
Скрыть — .tooltip («скрыть»)
Уничтожить — .tooltip (‘уничтожить’)
пример
В следующем примере демонстрируется использование плагина всплывающей подсказки через атрибуты данных.
<div style = "padding: 100px 100px 10px;"> This is a <a href = "#" class = "tooltip-show" data-toggle = "tooltip" title = "show">Tooltip on method show</a>. This is a <a href = "#" class = "tooltip-hide" data-toggle = "tooltip" data-placement = "left" title = "hide">Tooltip on method hide</a>. This is a <a href = "#" class = "tooltip-destroy" data-toggle = "tooltip" data-placement = "top" title = "destroy">Tooltip on method destroy</a>. This is a <a href = "#" class = "tooltip-toggle" data-toggle = "tooltip" data-placement = "bottom" title = "toggle">Tooltip on method toggle</a>. <br><br><br><br><br><br> <p class = "tooltip-options" > This is a <a href = "#" data-toggle = "tooltip" title = "<h2>'am Header2 </h2>">Tooltip on method options</a>. </p> <script> $(function () { $('.tooltip-show').tooltip('show');}); $(function () { $('.tooltip-hide').tooltip('hide');}); $(function () { $('.tooltip-destroy').tooltip('destroy');}); $(function () { $('.tooltip-toggle').tooltip('toggle');}); $(function () { $(".tooltip-options a").tooltip({html : true });}); </script> </div>
События
В следующей таблице перечислены события для работы с плагином всплывающей подсказки. Это событие может быть использовано для подключения к функции.
Событие | Описание | пример |
---|---|---|
show.bs.tooltip | Это событие происходит сразу же после вызова метода show instance. |
$('#myTooltip').on('show.bs.tooltip', function () { // do something }) |
shown.bs.tooltip | Это событие вызывается, когда всплывающая подсказка становится видимой для пользователя (будет ожидать завершения переходов CSS). |
$('#myTooltip').on('shown.bs.tooltip', function () { // do something }) |
hide.bs.tooltip | Это событие вызывается сразу же после вызова метода hide instance. |
$('#myTooltip').on('hide.bs.tooltip', function () { // do something }) |
hidden.bs.tooltip | Это событие вызывается, когда всплывающая подсказка закончила скрываться от пользователя (будет ожидать завершения переходов CSS). |
$('#myTooltip').on('hidden.bs.tooltip', function () { // do something }) |
пример
В следующем примере демонстрируется использование плагина всплывающей подсказки через атрибуты данных.