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 на вашем сайте

Пример

<div class="container">
<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.

Пример

<!DOCTYPE html>
<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).

Пример

<div class="container">
<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. Этот пример также демонстрирует, как использовать несколько опций вместе.

Пример

<div class="container">
<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 и файлы изображений, используемые в этом руководстве.

Другие расширения