Tooltips: Diretrizes
Os tooltips exibem rótulos ou mensagens breves.

Uso
Um tooltip fornece contexto adicional para um elemento de interface.
Tooltips simples
Tooltips simples descrevem brevemente um elemento de interface. Eles são mais indicados para rotular elementos de interface sem texto, como botões apenas com ícone e campos sem rótulo.
Tooltips ricos
Tooltips ricos fornecem contexto adicional sobre um elemento de interface. Eles podem incluir, opcionalmente, um subtítulo, botões e hiperlinks.
Tooltips ricos são mais indicados para textos mais longos, como definições ou explicações.

- Tooltip simples
- Tooltip rico




Anatomia
Tooltip simples

- Contêiner
- Texto de apoio
Texto de apoio


Tooltip rico

- Subtítulo (opcional)
- Contêiner
- Texto de apoio
- Botão de texto (opcional)
Subtítulo (opcional)
Mantenha os subtítulos curtos, de preferência em uma única linha. Eles devem resumir ou descrever a mensagem do tooltip rico.
É importante incluir um subtítulo quando o tooltip rico aparece automaticamente, como ao carregar a página.


Botões de texto (opcionais)
Tooltips ricos podem ter até dois botões de texto. Os rótulos dos botões devem ser breves e relevantes para a mensagem do texto de apoio.
Mantenha os rótulos dos botões curtos para que possam ficar lado a lado. Evite empilhar os botões sempre que possível.

Posicionamento
Tooltips simples
Por padrão, tooltips simples são posicionados diretamente acima do elemento pai.
- Se o elemento tiver um limite visual, como um botão, a distância até o tooltip é de 4dp
- Se o elemento não tiver um limite visual, como no caso de linhas de base de texto, a distância é de 8dp
Se o elemento estiver em uma barra de aplicativos, o tooltip simples aparece abaixo do elemento, mantendo a mesma distância.

Tooltips ricos
Por padrão, tooltips ricos são posicionados abaixo e à direita do elemento pai. A posição é ajustada para manter o tooltip dentro da tela. Os tooltips não devem cobrir o elemento pai.
Posicionamento dinâmico
A posição do tooltip é ajustada em intervalos de 8dp para evitar que ele saia da tela.
Posicionamento no desktop
No desktop, os tooltips podem aparecer centralizados abaixo do elemento pai e permanecer visíveis enquanto o cursor se move dentro da região-alvo.

Comportamento
Para mostrar um tooltip, passe o mouse sobre o elemento pai no desktop ou toque e segure o elemento em dispositivos móveis. Os tooltips ricos persistentes só aparecem quando o elemento pai é clicado ou tocado.
Transitórios por padrão
Tanto os tooltips simples quanto os ricos desaparecem após 1,5 segundos quando o cursor sai da região-alvo.
Abrir um novo tooltip fecha imediatamente qualquer outro tooltip que esteja aberto.

Tooltips ricos persistentes
Tooltips ricos persistentes aparecem quando uma das seguintes condições é atendida:
- O elemento pai é clicado
- A página é carregada e um novo recurso está sendo explicado
Tooltips ricos persistentes permanecem ativos mesmo quando o cursor sai da região-alvo. Eles só desaparecem quando a pessoa interage com outro elemento de interface. Passar o mouse não os aciona.
Ao aparecer durante o carregamento da página, o tooltip pode apresentar e explicar novos recursos em vários elementos pais.
Evite usar tooltips ricos persistentes em botões apenas com ícone.
