O Tooltip é geralmente usado para adicionar descrições a ícones; seu conteúdo é geralmente texto simples, sem imagens ou texto formatado.
Diretrizes de design do Material Design: Componentes - Tooltips
Desta forma, não é necessário escrever código JavaScript. Basta adicionar o atributo mdui-tooltip="options" ao elemento para ativar o plugin.
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Imprimir'}">
<i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Imprimir', position: 'top'}">
<i class="mdui-icon material-icons">local_printshop</i>
</button>
<button class="mdui-btn mdui-btn-icon" mdui-tooltip="{content: 'Imprimir', delay: 1000}">
<i class="mdui-icon material-icons">local_printshop</i>
</button>Instanciar componente:
// selector é um seletor CSS ou elemento DOM
// options são parâmetros de configuração, veja a lista de parâmetros abaixo
var inst = new mdui.Tooltip(selector, options);| Nome do parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
position | string | auto | A posição do Tooltip. Os valores possíveis incluem auto, bottom, top, left, right.Quando definido como auto, a posição será determinada automaticamente. A posição padrão é abaixo. A prioridade é bottom > top > left > right |
delay | int | 0 | Atraso para disparar, em milissegundos. |
content | string | Conteúdo do Tooltip. |
| Nome do método | Descrição |
|---|---|
open() | Abrir Tooltip Permite passar parâmetros de configuração para que o conteúdo possa ser modificado cada vez que for aberto, por exemplo, |
close() | Fechar Tooltip |
toggle() | Alternar o estado do Tooltip |
getState() | Retorna o estado do Tooltip. Contém quatro estados (opening, opened, closing, closed). |
| Nome do evento | Descrição | Parâmetros |
|---|---|---|
open.mdui.tooltip | O evento é disparado quando a animação de abertura começa. | event._detail.inst: instância |
opened.mdui.tooltip | O evento é disparado quando a animação de abertura termina. | |
close.mdui.tooltip | O evento é disparado quando a animação de fechamento começa. | |
closed.mdui.tooltip | O evento é disparado quando a animação de fechamento termina. |