menuMDUIDocs
color_lens
Zcela nové mdui 2 založené na Material Design 3 a Web Components bylo vydáno, přejděte na dokumentaci mdui 2.

Tooltip

Tooltip (nástrojový tip) se obvykle používá k doplnění popisu k ikonám. Jeho obsahem bývá prostý text bez obrázků či formátování.

Způsob volání

  1. Volání přes atributy
  2. Volání přes JavaScript

Způsob volání

Volání přes atributy

Tímto způsobem není třeba psát kód v JavaScriptu. Ke spuštění pluginu stačí k danému prvku přidat atribut mdui-tooltip="options".

Příklad
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Tisk'}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Tisk', position: 'top'}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Tisk', delay: 1000}">
  <i class="mdui-icon material-icons">local_printshop</i>
</button>

Volání přes JavaScript

Inicializace komponenty:

// selector je CSS selektor nebo DOM prvek
// options jsou konfigurační parametry, viz seznam parametrů níže
var inst = new mdui.Tooltip(selector, options);
Spustit

Parametr

Název parametruTypVýchozí hodnotaPopis
positionstringautoPozice tooltipu. Možné hodnoty jsou auto, bottom, top, left, right.
Při nastavení auto se pozice určí automaticky (výchozí je dole). Priorita určení je bottom > top > left > right.
delayint0Zpoždění zobrazení v ms.
contentstringObsah tooltipu.

Metoda

Název metodyPopis
open()

Otevře tooltip.

Umožňuje předat konfigurační parametry pro změnu obsahu při každém otevření, například open({ content: 'nový obsah' }). Seznam viz parametry výše.

close()Zavře tooltip.
toggle()Přepne stav tooltipu.
getState()Vrátí stav tooltipu. Možné stavy jsou opening, opened, closing, closed.

Událost

Název událostiPopisParametry
open.mdui.tooltipUdálost bude spuštěna při zahájení animace otevírání.event._detail.inst: instance
opened.mdui.tooltipUdálost bude spuštěna po dokončení animace otevírání.
close.mdui.tooltipUdálost bude spuštěna při zahájení animace zavírání.
closed.mdui.tooltipUdálost bude spuštěna po dokončení animace zavírání.