Добавить popover
Добавить popover
Легкая, расширяемая директива для создания причудливых всплывающих окон. Директива popover поддерживает несколько размещений, необязательную анимацию перехода и многое другое.
Как и плагин Bootstrap jQuery, для всплывающего окна требуется модуль tooltip.
Note
Обратите внимание, что хотя всплывающие окна могут корректно работать на мобильных устройствах (включая планшеты), мы приняли решение официально не поддерживать такой вариант использования, поскольку он не имеет смысла с точки зрения UX.
Существует три версии всплывающего окна: uib-popover и uib-popover-template, а также uib-popover-html:
- uib-popover - принимает только текст и не понимает HTML, предоставленного для тела всплывающего окна.
- uib-popover-html - принимает выражение, результатом которого является строка HTML. Обратите внимание, что этот HTML-код не компилируется. Если требуется компиляция, используйте вместо этого параметр атрибута uib-popover-template. Пользователь несет ответственность за безопасное размещение содержимого в DOM!
- uib-popover-template - URL-адрес, представляющий расположение шаблона, используемого для тела всплывающего окна. Обратите внимание, что содержимое этого шаблона необходимо заключить в тег, например, <div></div>.
uib-popover-* настройки
Все эти настройки доступны для трех типов всплывающих окон.
- popover-animation (Default: true, Config: animation) - Должен ли он исчезать и появляться?
- popover-append-to-body (Default: false, Config: appendToBody) - Следует ли добавлять всплывающее окно к $body вместо родительского элемента?
- popover-class - Пользовательский класс, который будет применяться к всплывающему окну.
- popover-enable (Default: true) - Это включено? Это включит или отключит настроенный триггер всплывающего окна.
- popover-is-open (Default: false) - Показывать ли всплывающее окно.
- popover-placement (Default: top, Config: placement) - Передача «авто», разделенных пробелом, перед местом размещения включит автоматическое позиционирование, например: «авто в нижнем левом углу». Всплывающее окно попытается разместить там, где оно соответствует ближайшему прокручиваемому предку. Принимает:
-
- top - всплывающее окно сверху, горизонтально по центру основного элемента.
-
- top-left - всплывающее окно сверху, левый край выровнен с левым краем основного элемента.
-
- top-right - всплывающее окно сверху, правый край выровнен с правым краем основного элемента.
-
- bottom - всплывающее окно внизу, горизонтально по центру основного элемента.
-
- bottom-left - всплывающее окно снизу, левый край выровнен с левым краем основного элемента.
-
- bottom-right - всплывающее окно снизу, правый край выровнен с правым краем основного элемента.
-
- left - всплывающее окно слева, вертикально по центру основного элемента.
-
- left-top - всплывающее окно слева, верхний край выровнен с верхним краем основного элемента.
-
- left-bottom - всплывающее окно слева, нижний край выровнен с нижним краем основного элемента.
-
- right - всплывающее окно справа, вертикально по центру основного элемента.
-
- right-top - всплывающее окно справа, верхний край выровнен с верхним краем основного элемента.
-
- right-bottom - всплывающее окно справа, нижний край выровнен с нижним краем основного элемента.
- popover-popup-close-delay (Default: 0, Config: popupCloseDelay) - Как долго всплывающее окно должно оставаться открытым после триггерного события закрытия?
- popover-popup-delay (Default: 0, Config: popupDelay) - Задержка всплывающего окна в миллисекундах до его открытия.
- popover-title - Строка, отображаемая как причудливый заголовок.
- popover-trigger (Default: 'click') - Что должно вызвать появление всплывающего окна? Поддерживает список имен событий или объектов, разделенных пробелами (см. Ниже).
Note
Чтобы настроить всплывающие подсказки, вам нужно сделать это в $uibTooltipProvider (также см. Ниже).
Triggers
Следующие триггеры показа поддерживаются 'из коробки' вместе с предоставленными им триггерами скрытия:
- mouseenter: mouseleave
- click: click
- outsideClick: outsideClick
- focus: blur
- none
Триггер outsideClick заставит всплывающее окно переключаться при щелчке и скрываться при нажатии на что-либо еще.
Для любого неподдерживаемого значения триггер будет использоваться как для отображения, так и для скрытия всплывающего окна. Использование триггера none отключит внутренние триггеры, затем можно использовать атрибут popover-is-open исключительно для отображения и скрытия всплывающего окна.
$uibTooltipProvider
С помощью $uibTooltipProvider вы можете изменить поведение всплывающих подсказок и всплывающих окон по умолчанию; атрибуты выше всегда имеют приоритет. Доступны следующие методы:
- setTriggers(obj) (Example: { 'openTrigger': 'closeTrigger' }) - Расширяет сопоставления триггеров по умолчанию, упомянутые выше, собственными сопоставлениями.
- options(obj) - Задайте набор значений по умолчанию для определенных атрибутов всплывающих подсказок и всплывающих окон.
Известные проблемы
Для поддержки Safari 7+, если вы хотите использовать всплывающий-триггер фокуса, вам необходимо использовать тег привязки с индексом вкладки. Например:
<a tabindex="0" uib-popover="Test" popover-trigger="focus" class="btn btn-default">
Click Me
</a>
Примеры
<div ng-controller="PopoverDemoCtrl">
<h4>Dynamic</h4>
<div class="form-group">
<label>Popup Text:</label>
<input type="text" ng-model="dynamicPopover.content" class="form-control">
</div>
<div class="form-group">
<label>Popup Title:</label>
<input type="text" ng-model="dynamicPopover.title" class="form-control">
</div>
<div class="form-group">
<label>Popup Template:</label>
<input type="text" ng-model="dynamicPopover.templateUrl" class="form-control">
</div>
<button uib-popover="{{dynamicPopover.content}}" popover-title="{{dynamicPopover.title}}" type="button" class="btn btn-default">Dynamic Popover</button>
<button uib-popover-template="dynamicPopover.templateUrl" popover-title="{{dynamicPopover.title}}" type="button" class="btn btn-default">Popover With Template</button>
<script type="text/ng-template" id="myPopoverTemplate.html">
<div>{{dynamicPopover.content}}</div>
<div class="form-group">
<label>Popup Title:</label>
<input type="text" ng-model="dynamicPopover.title" class="form-control">
</div>
</script>
<hr />
<h4>Positional</h4>
<div class="form-group">
<label>Popover placement</label>
<select class="form-control" ng-model="placement.selected" ng-options="o as o for o in placement.options"></select>
</div>
<button popover-placement="{{placement.selected}}" uib-popover="On the {{placement.selected}}" type="button" class="btn btn-default">Popover {{placement.selected}}</button>
<hr />
<h4>Triggers</h4>
<p>
<button uib-popover="I appeared on mouse enter!" popover-trigger="'mouseenter'" type="button" class="btn btn-default">Mouseenter</button>
</p>
<input type="text" value="Click me!" uib-popover="I appeared on focus! Click away and I'll vanish..." popover-trigger="'focus'" class="form-control">
<hr />
<h4>Other</h4>
<button popover-animation="true" uib-popover="I fade in and out!" type="button" class="btn btn-default">fading</button>
<button uib-popover="I have a title!" popover-title="The title." type="button" class="btn btn-default">title</button>
<button uib-popover="I am activated manually" popover-is-open="popoverIsOpen" ng-click="popoverIsOpen = !popoverIsOpen" type="button" class="btn btn-default">Toggle popover</button>
<button uib-popover-html="htmlPopover" class="btn btn-default">HTML Popover</button>
<button uib-popover-html="'<b>HTML</b>, <i>inline</i>'" class="btn btn-default">HTML Popover (inline)</button>
</div>
angular.module('ui.bootstrap.demo').controller('PopoverDemoCtrl', function ($scope, $sce) {
$scope.dynamicPopover = {
content: 'Hello, World!',
templateUrl: 'myPopoverTemplate.html',
title: 'Title'
};
$scope.placement = {
options: [
'top',
'top-left',
'top-right',
'bottom',
'bottom-left',
'bottom-right',
'left',
'left-top',
'left-bottom',
'right',
'right-top',
'right-bottom'
],
selected: 'top'
};
$scope.htmlPopover = $sce.trustAsHtml('<b style="color: red">I can</b> have <div class="label label-success">HTML</div> content');
});
