Bootstrap Popover
Описание
Bootstrap Popover создается с помощью пользовательского плагина Jquery. Его можно использовать для отображения некоторой информации для любого элемента.
В этом руководстве вы увидите, как использовать Bootstrap Popover и как настроить его с помощью некоторых доступных параметров.
Что требуется
Вы должны подключить Jquery, Bootstrap CSS и два файла JavaScript — один для Bootstrap Tooltip (плагин tooltip) и один для Bootstrap Popover.
Файл JS для Tooltip (плагин tooltip) находится в папке js внутри вашей папки Bootstrap и называется bootstrap-tooltip.js. Файл JS для Popover находится в папке js внутри вашей основной папки Bootstrap и называется bootstrap-popover.js. Jquery находится в docs > assets > js в вашей основной папке Bootstrap и называется jquery.js. В качестве альтернативы вы можете напрямую посетить https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js, чтобы скачать Jquery.
Пожалуйста, убедитесь, что вы скачали bootstrap-tooltip.js до того, как скачаете bootstrap-popover.js. Popover зависит от плагина tooltip, поэтому плагин tooltip нужно загрузить первым.
Использование Bootstrap Popover на вашем сайте
Пример
<h2>Создание Popover с помощью Bootstrap</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-danger" rel="popover" data-content="Это так просто — создать всплывающую подсказку для моего сайта!" data-original-title="Twitter Bootstrap Popover">наведите курсор для Popover</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover();
});
</script>
Посмотреть пример онлайн
Объяснение
В таблице ниже объясняется приведённый выше код. Это поможет вам понять, как использовать Bootstrap Popover.
| Code | Объяснение |
|---|---|
| id="example" | Назначьте id соответствующему якорю; значение id указывает на JavaScript, который позже реализует popover. |
| class="btn btn-danger" | Создайте кнопку. btn btn-danger — это класс, используемый в примере. Вы можете взять любой другой класс из Bootstrap CSS или воспользоваться своим пользовательским классом. |
| data-content="Это так просто — создать подсказку для моего сайта!" | Значение data-content отображается в теле popover. |
| data-original-title="Bootstrap Popover" | Значение data-original-title отображается как заголовок popover. |
| наведение для popover | Текст якоря. |
| Подключите Jquery. | |
| Подключите JS-файл для Bootstrap Tooltip (плагин tooltip). | |
| Подключите JS-файл для Bootstrap Popover. | |
| $(function () | Подготовьте документ. Команда Jquery. |
| $("#example").popover(); | Обратитесь к id example и примените popover() к нему. |
Здесь мы не создавали popover вне блока, без какой-либо настройки, т.е. мы не использовали никаких опций через popover().
Использование
Итак, можно обобщить использование Bootstrap Popover следующим образом:
$(function ()
{ $("identifier").popover(options);
});
Гдеidentifier— это Jquery-селектор, используемый для определения соответствующего элемента контейнера. Далее давайте посмотрим наoptions— что они собой представляют.
Параметры
Ниже приведены некоторые опции, которые вы можете использовать с popover() для настройки внешнего вида и поведения Popover.
animation
Тип значения animation — boolean, значение по умолчанию — true. Оно используется, чтобы придать всплывающей подсказке (плагину tooltip) эффект CSS-градиентного перехода.
placement
Значение placement может быть типа string или function, со значением по умолчанию 'right'. top, bottom и left — другие допустимые значения. Эта опция используется для определения положения Popover (popover) относительно текста привязки. Ниже приведён пример использования опции placement.
Пример
<html lang="en">
<head>
<meta charset="utf-8">
<title>Пример размещения Bootstrap Popover</title>
<meta name="description" content="Создание модального окна с Twitter Bootstrap">
<link href="../twitter-bootstrap/twitter-bootstrap-v2/docs/assets/css/bootstrap.css.html" rel="stylesheet">
<style>
a {
margin-left : 400px;
}
</style>
</head>
<body>
<div class="container">
<h2>Создание Popover с использованием опции размещения Bootstrap</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover" data-content="Создание всплывающей подсказки для моего сайта — это так просто!" data-original-title="Twitter Bootstrap Popover">Наведите курсор для Popover</a>
</div>
<div class="well">
<a href="../index.html" id="example_left" class="btn btn-success" rel="popover" data-content="Создание всплывающей подсказки для моего сайта — это так просто!" data-original-title="Twitter Bootstrap popover">Наведите для появления</a>
</div>
<div class="well">
<a href="../index.html" id="example_top" class="btn btn-success" rel="popover" data-content="Создание всплывающей подсказки для моего сайта — это так просто!" data-original-title="Twitter Bootstrap popover">Наведите для появления</a>
</div>
<div class="well">
<a href="../index.html" id="example_bottom" class="btn btn-success" rel="popover" data-content="Создание popover для моего сайта — это так просто!" data-original-title="Twitter Bootstrap Popover">Popover при наведении</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover();
$("#example_left").popover({placement:'left'});
$("#example_top").popover({placement:'top'});
$("#example_bottom").popover({placement:'bottom'});
});
</script>
</body>
</html>
Посмотреть пример онлайн
selector
Тип значения selector — строка, значение по умолчанию — false. Используя эту опцию, объект Tooltip можно делегировать указанному целевому элементу.
trigger
Тип значения trigger может быть строкой, значение по умолчанию — 'hover'. focus и manual — другие допустимые значения. Эта опция используется для определения того, как запускается tooltip (плагин tooltip). Следующий пример демонстрирует, как использовать опцию focus для запуска Popover (popover).
Пример
<h2>Использование опции trigger в Bootstrap для создания popover</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover" data-content="Создание всплывающей подсказки для моего сайта — это так просто!" data-original-title="Twitter Bootstrap Popover">Наведите курсор для Popover</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover({trigger: 'focus'});
});
</script>
Посмотреть пример онлайн
title
Тип значения title может быть строкой или функцией, значение по умолчанию — ''. То есть значение атрибута title по умолчанию не отображается.
content
Тип значения content может быть строкой или функцией, значение по умолчанию — ''. То есть значение атрибута data-content по умолчанию не отображается. Ниже приведён пример использования опций title и data-content. Этот пример также демонстрирует, как использовать несколько опций вместе.
Пример
<h2>Popover в Bootstrap использует опции title и content</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover">Popover при наведении</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover({title: 'Twitter Bootstrap Popover', content: "Creating a popover for my website is so simple!"});
});
</script>
Посмотреть пример онлайн
delay
Тип значения `delay` может быть `number` или `object`, значение по умолчанию — 0. Это определяет время ожидания для показа и скрытия всплывающего окна в миллисекундах. Если значение задано числом, время ожидания применяется как к показу, так и к скрытию. Если значение задано объектом, структура имеет вид `delay: { show: 500, hide: 100}`, где 500 и 100 указаны в миллисекундах.
Изменение стандартной разметки и стиля всплывающего окна
Стандартная разметка всплывающего окна Popover находится в строке 92 файла bootstrap-popover.js. Как показано ниже:
template: '<div class="popover"><div class="arrow"></div><div class="popover-inner"><h3 class="popover-title"></h3><div class="popover-content"><p></p></div></div></div>'
Вы можете изменить её и вставить свою собственную разметку.
Стандартные стили всплывающего окна Popover находятся в строках с 3027 по 3118. Вы можете изменить их и вставить свои собственные стили.
Нажмите здесь, чтобы скачать все HTML, CSS, JS и файлы изображений, используемые в этом руководстве.
Другие расширения