Документация и примеры добавления настраиваемых всплывающих подсказок Bootstrap с помощью CSS и JavaScript с использованием CSS3 для анимации и атрибутов данных для локального хранения заголовков.
Обзор
Что нужно знать при использовании плагина всплывающей подсказки:
Всплывающие подсказки полагаются на стороннюю библиотеку Popper.js для позиционирования. Вы должны включить popper.min.js перед bootstrap.js или использовать bootstrap.bundle.min.js / bootstrap.bundle.js , который содержит Popper.js, чтобы всплывающие подсказки работали!
Если вы создаете наш JavaScript из исходного кода, для этого требуется util.js .
Подсказки добавляются по соображениям производительности, поэтому вы должны инициализировать их самостоятельно .
Подсказки с заголовками нулевой длины никогда не отображаются.
Укажите container: 'body' , чтобы избежать проблем с рендерингом в более сложных компонентах (таких как наши группы ввода, группы кнопок и т. д.).
Не работают всплывающие подсказки для скрытых элементов.
Подсказки для элементов .disabled или disabled должны активироваться на элементе-оболочке.
При срабатывании гиперссылок, охватывающих несколько строк, всплывающие подсказки будут располагаться по центру. Используйте пробел : nowrap; на , чтобы избежать такого поведения.
Всплывающие подсказки должны быть скрыты до того, как соответствующие им элементы будут удалены из модели DOM.
Все понял? Отлично, давайте посмотрим, как они работают, на нескольких примерах.
Пример: включить всплывающие подсказки везде
Один из способов инициализировать все всплывающие подсказки на странице — выбрать их по атрибуту data-toggle :
Наведите указатель мыши на ссылки ниже, чтобы увидеть всплывающие подсказки:
Узкие штаны следующего уровня куфии вы, наверное, не слышали о них. Фотобудка с бородой из необработанного денима, высокой печатью, веганская сумка через плечо, Stumptown. Сейтан от фермы к столу, 8-битная американская одежда McSweeney’s Fixie из устойчивой лебеды имеет виниловое шамбре Terry Richardson. Бородатый тупиковый город, кардиганы банх ми ломо тандеркэтс. Биодизель с тофу Уильямсбург Марфа, очищающий веганский шамбре четырех локо Максуини. По-настоящему ироничный ремесленник, какой бы кейтар ни был, сценастер, от фермы до стола, Бэнкси Остин, твиттер, ручка, фриган, кредо, сырой деним, вирусный кофе одного происхождения.
Наведите указатель мыши на кнопки ниже, чтобы увидеть четыре направления всплывающих подсказок: вверх, вправо, вниз и влево.
И с добавлением пользовательского HTML:
Подсказка с HTML
Использование
Подключаемый модуль всплывающих подсказок генерирует содержимое и разметку по запросу и по умолчанию размещает всплывающие подсказки после их триггерного элемента.
Активировать всплывающую подсказку через JavaScript:
$('#example').tooltip(options)
Разметка
Необходимая разметка для всплывающей подсказки — это только атрибут данных и заголовок в элементе HTML, для которого вы хотите иметь всплывающую подсказку. Сгенерированная разметка всплывающей подсказки довольно проста, хотя для нее требуется позиция (по умолчанию, установленная плагином на сверху ).
Обеспечение работы всплывающих подсказок для пользователей клавиатуры и вспомогательных технологий
Вы должны добавлять всплывающие подсказки только к элементам HTML, которые традиционно активны с помощью клавиатуры и являются интерактивными (например, ссылки или элементы управления формы). Хотя произвольные элементы HTML (например, s) можно сделать фокусируемым, добавив атрибут tabindex="0" , это добавит потенциально раздражающие и запутанные позиции табуляции на неинтерактивных элементах для пользователей клавиатуры.
Кроме того, большинство вспомогательных технологий в настоящее время не объявляют всплывающую подсказку в этой ситуации.
Кроме того, не полагайтесь исключительно на наведение в качестве триггера для всплывающей подсказки, так как это сделает ваши всплывающие подсказки невозможными для пользователей клавиатуры.
<дел>дел>
<дел>
Какой-то текст всплывающей подсказки!
дел>
Отключенные элементы
Элементы с отключенным атрибутом не являются интерактивными, то есть пользователи не могут сфокусироваться, навести курсор или щелкнуть их, чтобы вызвать всплывающую подсказку (или всплывающую подсказку). В качестве обходного пути вы захотите вызвать всплывающую подсказку из оболочки
или , в идеале сфокусируемой на клавиатуре с помощью tabindex="0" , и переопределить событий указателя на отключенный элемент.
Кнопка отключена
Опции
Параметры можно передавать через атрибуты данных или JavaScript. Для атрибутов данных добавьте имя опции к data-, например data-animation="" .
Имя
Тип
По умолчанию
Описание
анимация
логическое значение
правда
Применить переход затухания CSS к всплывающей подсказке
контейнер
строка | элемент | ложь
ложь
Добавляет всплывающую подсказку к определенному элементу. Пример: контейнер : 'тело' . Этот параметр особенно удобен тем, что позволяет расположить всплывающую подсказку в потоке документа рядом с активирующим элементом, что предотвратит всплывающую подсказку от триггерного элемента во время изменения размера окна.
задержка
номер | объект
0
Задержка отображения и скрытия всплывающей подсказки (мс) — не относится к ручному типу триггера
Если указано число, применяется задержка как для скрытия, так и для отображения
Структура объекта: задержка: { "показать": 500, "скрыть": 100}
HTML
логическое значение
ложь
Разрешить HTML во всплывающей подсказке.
Если задано значение true, теги HTML в заголовке всплывающей подсказки будут отображаться во всплывающей подсказке. Если false, метод jQuery text будет использоваться для вставки содержимого в DOM.
Используйте текст, если вы беспокоитесь о XSS-атаках.
размещение
строка | функция
‘верхний’
Как расположить всплывающую подсказку — авто | топ | дно | слева | верно. Когда 9Если указано 0010 auto
, это будет динамически переориентировать всплывающую подсказку.
Когда функция используется для определения размещения, она вызывается с узлом DOM всплывающей подсказки в качестве первого аргумента и узлом DOM триггерного элемента в качестве второго. Контекст this установлен на экземпляр всплывающей подсказки.
селектор
строка | ложь
ложь
Если предоставлен селектор, объекты всплывающей подсказки будут делегированы указанным целям. На практике это используется для включения всплывающих окон в динамический HTML-контент. См. это и информативный пример.
шаблон
строка
'
'
Базовый HTML для использования при создании всплывающей подсказки.
Заголовок всплывающей подсказки будет вставлен в . tooltip-inner .
.arrow станет стрелкой всплывающей подсказки.
Самый внешний элемент-оболочка должен иметь .tooltip класс и role="tooltip" .
наименование
строка | элемент | функция
''
Значение заголовка по умолчанию, если атрибут title отсутствует.
Если задана функция, она будет вызываться со своей этой ссылкой , установленной на элемент, к которому прикреплена всплывающая подсказка.
курок
строка
'наведение фокуса'
Как срабатывает всплывающая подсказка - нажмите | парить | фокус | руководство. Вы можете передать несколько триггеров; разделяйте их пробелом.
'manual' указывает, что всплывающая подсказка будет запускаться программно с помощью методов . tooltip('show') , .tooltip('hide') и .tooltip('toggle') ; это значение нельзя комбинировать ни с каким другим триггером.
'hover' сам по себе приведет к всплывающим подсказкам, которые нельзя активировать с помощью клавиатуры, и их следует использовать только в том случае, если существуют альтернативные методы передачи той же информации для пользователей клавиатуры.
смещение
номер | строка
0
Смещение всплывающей подсказки относительно цели. Для получения дополнительной информации обратитесь к документации по смещению Popper.js.
резервное размещение
строка | массив
'флип'
Позволяет указать, какую позицию Поппер будет использовать при откате. Для получения дополнительной информации см.
Документы о поведении Popper.js
граница
строка | элемент
'родительский прокрутки'
Граница ограничения переполнения всплывающей подсказки. Принимает значения 'viewport' , 'window' , 'scrollParent' или ссылку HTMLElement (только JavaScript). Для получения дополнительной информации обратитесь к документации по предотвращению переполнения Popper.js.
Методы
Асинхронные методы и переходы
Все методы API являются асинхронными и запускают переход . Они возвращаются к вызывающей стороне, как только переход начинается, но до его завершения . Кроме того, вызов метода для переходного компонента будет игнорироваться .
Дополнительные сведения см. в нашей документации по JavaScript.
$(). Подсказка (параметры)
Добавляет обработчик всплывающей подсказки к коллекции элементов.
.tooltip('показать')
Показывает всплывающую подсказку элемента. Возвращает вызывающему объекту до того, как всплывающая подсказка действительно была показана (т. е. до того, как произойдет событие visible.bs.tooltip ). Это считается «ручным» срабатыванием всплывающей подсказки. Подсказки с заголовками нулевой длины никогда не отображаются.
$('#element').tooltip('show')
.tooltip('hide')
Скрывает всплывающую подсказку элемента. Возвращает вызывающему объекту до того, как всплывающая подсказка будет фактически скрыта (т. е. до того, как произойдет событие hidden.bs.tooltip ). Это считается «ручным» срабатыванием всплывающей подсказки.
$('#element').tooltip('скрыть')
.tooltip('переключить')
Переключает всплывающую подсказку элемента. Возвращает вызывающему объекту до того, как всплывающая подсказка действительно была показана или скрыта (т.0010 hidden.bs.tooltip событие). Это считается «ручным» срабатыванием всплывающей подсказки.
$('#element'). tooltip('toggle')
.tooltip('dispose')
Скрывает и уничтожает всплывающую подсказку элемента. Всплывающие подсказки, использующие делегирование (которые создаются с помощью параметра селектора ), не могут быть уничтожены по отдельности в элементах-триггерах-потомках.
$('#element').tooltip('dispose')
.tooltip('enable')
Позволяет отображать всплывающую подсказку элемента. Подсказки включены по умолчанию.
$('#element').tooltip('enable')
.tooltip('disable')
Удаляет возможность отображения всплывающей подсказки элемента. Всплывающая подсказка будет отображаться только в том случае, если она снова включена.
$('#element').tooltip('disable')
.tooltip('toggleEnabled')
Переключает возможность отображения или скрытия всплывающей подсказки элемента.
$('#element').tooltip('toggleEnabled')
.tooltip('update')
Обновляет положение всплывающей подсказки элемента.
$('#element').tooltip('update')
События
Тип события
Описание
show.bs.tooltip
Это событие возникает немедленно при вызове метода экземпляра show .
показана подсказка
Это событие запускается, когда всплывающая подсказка становится видимой для пользователя (будет ожидать завершения переходов CSS).
hide.bs.tooltip
Это событие запускается сразу после вызова метода экземпляра hide .
hidden.bs.tooltip
Это событие запускается, когда всплывающая подсказка перестает быть скрытой от пользователя (будет ожидать завершения переходов CSS).
вставленная.bs.подсказка
Это событие запускается после события show.bs.tooltip , когда шаблон всплывающей подсказки был добавлен в DOM.
$('#myTooltip').on('hidden.bs.tooltip', функция () {
// сделай что-нибудь…
})
Анимированные иконки | Font Awesome Docs
Наш набор Styling Toolkit избавляет от проблем с изменением размера, вращением и размещением значков, поэтому вы можете сделать свой сайт эффектным с помощью анимации.
Мы расскажем об основах анимации, таких как ритм, затухание, ритм-затухание, переворот и вращение, для ваших значков, чтобы вы могли создать больше визуального интереса на своем сайте.
Перед началом работы
Убедитесь, что вы:
Настройте Font Awesome в своем проекте.
Знаком с основами добавления значков Font Awesome.
Beat
Используйте анимацию fa-beat для увеличения или уменьшения значка. Это полезно для привлечения внимания или для использования со значками, ориентированными на здоровье / сердце.
Beat Utilities
Utility
Details
--fa-beat-scale
max 9014 0137
Fade
Используйте fa -fade анимация для визуального появления и исчезновения значка, чтобы привлечь внимание тонким (или не очень) способом.
Fade Utilities
Utility
Детали
--fa-fade-opacity
Установите наименьшее значение непрозрачности, до которого значок будет постепенно исчезать
Beat-Fade
Используйте анимацию fa0beat для захвата внимания визуальное масштабирование и пульсация значка.
Утилиты Beat-Fade
Утилита
Детали
--fa-beat-fade-opacity icon
будет исчезать до и от
--fa-beat-fade-scale
Установить максимальное значение масштабирования значка и вниз.
Bounce Utilities
Utility
Details
--fa-bounce-rebound имеет значок при приземлении после приземления
42 прыжок
--fa-bounce-height
Установите максимальную высоту, на которую подпрыгнет значок при отскоке («хлюпать») при начале отскока
--fa-bounce-start-scale-y
Установить вертикальное искажение значка («хлюпать») при начале отскока
--fa -bounce-jump-scale-x
Установить горизонтальное искажение значка ("сплющивание") в верхней части прыжка the jump
--fa-bounce-land-scale-x
Установите горизонтальное искажение значка ("squish") при приземлении после прыжка
--fa-bounce-land-scale -y
Установить вертикальное искажение значка ("хлюпать") при приземлении после прыжка
Flip
Используйте анимацию fa-flip для поворота значка в трехмерном пространстве (открывается в новом окне). По умолчанию флип поворачивает значок вокруг оси Y на 180 градусов. Переворот полезен для переходов, состояний обработки или для использования физических объектов, которые переворачиваются в реальном мире.
Flip Utilities
Utility
Details
--fa-flip-x
вращения (между 0 и 1 )
--fa-flip-y
Установить координату y вектора, обозначающего ось вращения (между 0 1 1 1 и 10 0137
--fa-flip-angle 2 Задать угол поворота флип. Положительный угол обозначает вращение по часовой стрелке, отрицательный угол — против часовой стрелки.
Встряхивание
Используйте анимацию fa-shake , чтобы привлечь внимание или отметить, что что-то не разрешено, покачивая значок вперед и назад.
Spin
Используйте класс fa-spin , чтобы заставить любой значок вращаться, и используйте fa-spin-pulse , чтобы он вращался с восемью шагами. Это особенно хорошо работает с fa-spinner и всем, что относится к категории значков счетчиков. Если вы хотите, чтобы значок вращался в обратном направлении (например, против часовой стрелки), добавьте дополнительный класс fa-spin-reverse .
Spin Utilities
Utility
Детали
fa-spin 90 90 10 вращение по часовой стрелке 3 значка вращения по часовой стрелке 3 значка 42
fa-spin-pulse
Заставляет значок вращаться 360° по часовой стрелке с шагом 8 шагов
fa-spin-reverse
При использовании в сочетании с fa-spin или fa-spin-pulse заставляет значок вращаться против часовой стрелки.
Мы устарели fa-pulse
Класс анимации fa-pulse , который мы использовали в предыдущих версиях Font Awesome, по-прежнему работает в версии 6. Но мы решили переименовать его в fa- спин-импульс . Мы считаем, что это имя более точно соответствует его назначению, и мы перенесем его для использования в будущих версиях.
Доступность
Использование анимации в Интернете наиболее доступным способом требует дополнительного внимания:
В общем, лучше всего использовать анимацию в Интернете как дополнительный способ, а не как единственный способ отметить изменение состояния в пользовательском интерфейсе. Не забудьте обновить текст действий и изменить другие визуальные аспекты элементов!
И когда дело доходит до времени и продолжительности анимации, избегайте изменения состояния чего-либо со скоростью три раза в секунду или чаще, что может вызвать светочувствительную эпилепсию.
Все включенные анимации теперь поддерживают и используют предпочитает уменьшенное движение Мультимедийная функция CSS (открывается в новом окне), чтобы определить, запросил ли пользователь, чтобы система минимизировала количество второстепенных движений, которые она использует.
Случай
Как это влияет на включенные анимации
Предпочтение не задано (по умолчанию)
Предпочтение будет отображаться как ожидается
уменьшить
Анимация будет отключена
Когда предпочитает меньшее движение установлено на уменьшить , это указывает на то, что пользователь предпочитает меньше движения, что может вызвать дискомфорт на странице у людей с вестибулярными нарушениями движения.
Настройка
Мы добавили настраиваемые свойства CSS (открывается в новом окне), чтобы сделать настройку проще и эффективнее, и вы можете использовать эти настраиваемые свойства во всех наших анимациях. Определите свои собственные значения для следующих свойств, чтобы переопределить и настроить параметры Font Awesome по умолчанию.
Пользовательское свойство CSS
Детали
Допустимые значения
--fa-animation-delay
2 Установить 1 задержку анимации
Любое допустимое значение CSS animation-delay ( открывает новое окно)
--fa-animation-direction
Установить направление анимации
Любое допустимое значение CSS animation-direction (открывает новое окно)
--fa-animation-duration
Установить продолжительность анимации
Любое допустимое значение CSS animation-duration (открывает новое окно)
--countation-animation 10-10itation
Установить количество итераций для анимации
Любое допустимое значение CSS animation-iteration-count (открывается в новом окне)
--fa-animation-timing
Установить, как анимация проходит через кадры
Любое допустимое значение CSS animation-timing-function (opens new window)
Icon Animation + Wobbles
Мы приложили много усилий, чтобы значки находились точно по центру, когда они вращаются или пульсируют.