menuMDUIDocs
color_lens
Новый mdui 2 на базе Material Design 3 и Web Components уже здесь. Перейти к документации mdui 2.

Тултипы

Тултип обычно используется для добавления пояснений к иконкам. Его содержимое обычно представляет собой простой текст без изображений и форматирования.

Использование

  1. Вызов через атрибуты
  2. Вызов через JavaScript

Использование

Вызов через атрибуты

Этот способ не требует написания JavaScript-кода. Просто добавьте атрибут mdui-tooltip="options" к элементу, чтобы активировать плагин.

Пример
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Печать'}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Печать', position: 'top'}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Печать', delay: 1000}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>

Вызов через JavaScript

Инициализация компонента:

// selector — это CSS-селектор или DOM-элемент.
// options — это параметры конфигурации, см. список параметров ниже.
var inst = new mdui.Tooltip(selector, options);
Запуск

Параметр

Имя параметраТипПо умолчаниюОписание
positionstringautoРасположение тултипа. Допустимые значения: auto, bottom, top, left, right.
При значении auto положение определяется автоматически. По умолчанию — снизу. Приоритет: bottom > top > left > right.
delayint0Задержка перед появлением в миллисекундах.
contentstringСодержимое тултипа.

Метод

Имя методаОписание
open()

Показать тултип

Позволяет передавать параметры конфигурации для изменения содержимого при каждом открытии, например: open({ content: 'новое содержимое' }). Список параметров см. в разделе Параметры выше.

close()Скрыть тултип
toggle()Переключить состояние тултипа
getState()Возвращает состояние тултипа. Всего существует четыре состояния (opening, opened, closing, closed).

Событие

Имя событияОписаниеПараметры
open.mdui.tooltipСобытие срабатывает, когда начинается анимация открытия.event._detail.inst: экземпляр
opened.mdui.tooltipСобытие срабатывает, когда анимация открытия завершена.
close.mdui.tooltipСобытие срабатывает, когда начинается анимация закрытия.
closed.mdui.tooltipСобытие срабатывает, когда анимация закрытия завершена.