Visão Geral do Tooltip
O componente Tooltip no App Builder permite que você exiba ajuda contextual ou informações complementares quando os usuários passam o mouse sobre ou focam em um elemento alvo em sua aplicação. Os Tooltips são configurados visualmente através do painel Propriedades, e seu gatilho e conteúdo podem ser totalmente personalizados sem escrever código.
Os Tooltips usam o componente subjacente Ignite UI Tooltip e geram código limpo e específico do framework para Angular, React, Blazor e Web Components.
Principais Características
Adicionando um Tooltip a um Componente
Os Tooltips são ativados diretamente no painel Propriedades do componente alvo. Para anexar um tooltip:
- Selecione o componente alvo na Tela de Design.
- No painel Propriedades, role até a seção Tooltip.
- Ative Ativar Tooltip.
- Clique no link Editar Tooltip que aparece para abrir o tooltip e configurar suas propriedades (Alvo, Modo, Atraso de exibição, Atraso de ocultação, Seta).
Alternativamente, você pode adicionar um Tooltip arrastando-o da Caixa de Ferramentas de Componentes ou usando o atalho quick-add Ctrl+E (⌘+E no Mac) e pesquisando por “Tooltip”.
Conteúdo do Tooltip
Você pode vincular o conteúdo do tooltip a uma variável ou um campo de dados de uma fonte de dados conectada, permitindo dicas dinâmicas e conscientes do contexto em tempo de execução.
Atraso de Exibição / Ocultação
Controle a responsividade dos tooltips definindo:
- Atraso de exibição — o tempo (ms) antes do tooltip aparecer depois que o usuário passa o mouse sobre o alvo. Padrão é 300 ms.
- Atraso de ocultação — o tempo (ms) antes do tooltip desaparecer depois que o cursor sai. Padrão é 0 ms.
Esses atrasos melhoram a usabilidade e evitam cintilação de tooltip para usuários que movem rapidamente o cursor entre vários elementos.
Modo
A propriedade Modo controla como o tooltip é descartado:
- Padrão — o tooltip aparece ao passar o mouse/focar e é descartado automaticamente quando o cursor ou foco sai do alvo.
- Fixo — o tooltip permanece visível até que o usuário o feche explicitamente.
Seta
Alterne o indicador de seta Arrow direcional para ligar ou desligar. Quando ativado, uma pequena seta aponta do tooltip para seu elemento alvo, tornando a associação entre o tooltip e seu alvo visualmente clara.
Gatilho do Tooltip
Por padrão, os tooltips são acionados em hover (mouse) e focus (teclado). Este comportamento duplo garante conformidade com acessibilidade com as diretrizes WCAG.
Propriedades Suportadas
| Propriedade | Descrição |
|---|---|
| Alvo | O componente ao qual o tooltip está anexado |
| Modo | Como o tooltip é descartado: padrão (automático) ou fixo (manual) |
| Atraso de exibição | Atraso (ms) antes do tooltip ser mostrado. Padrão é 300 |
| Atraso de ocultação | Atraso (ms) antes do tooltip ser ocultado. Padrão é 0 |
| Seta | Alterna o indicador de seta direcional para ligar ou desligar |
Acessibilidade
O componente Tooltip foi construído com acessibilidade em mente:
- O elemento alvo recebe
aria-describedbyvinculando-o ao conteúdo do tooltip. - Os Tooltips são acessíveis via teclado através de eventos de foco.
- Suporte a leitor de tela é fornecido através de funções ARIA apropriadas.
Geração de Código
O App Builder gera código de tooltip específico do framework com base em sua configuração visual:
- Angular: Usa as diretivas
igxTooltipeigxTooltipTargetdo Ignite UI para Angular. - React: Usa o componente
IgrTooltipdo Ignite UI para React. - Blazor: Usa
IgbTooltipdo Ignite UI para Blazor. - Web Components: Usa
igc-tooltipdo Ignite UI para Web Components.
Note
O conteúdo do Tooltip vinculado a variáveis ou campos de dados é refletido no código gerado como vinculações dinâmicas específicas de cada framework.
Problemas Conhecidos e Limitações
- Tooltips aninhados não são permitidos.
- Tooltips repetidos no código gerado:
- Angular ✔️
- React, Blazor, Web Components 🚧 — o tooltip não fica corretamente anexado ao alvo repetido.
- Tooltip em um item Select repetido: Os Tooltips anexados a itens Select repetidos não funcionam em Angular a menos que o atributo
ngProjectAsseja adicionado aong-containerque envolve o item selecionado. Por exemplo:
<igx-select type="border" class="user-input">
@for (item of northwindCategories; track item) {
<ng-container ngProjectAs="igx-select-item">
<igx-select-item value="Option" #selectItem [igxTooltipTarget]="tooltip4" [showDelay]="300" [hideDelay]="0">
{{ item.name }}
</igx-select-item>
<div #tooltip4="tooltip" igxTooltip>
<div class="column-layout group_1">
<p class="ig-typography__body-2 text">
{{ item.description }}
</p>
</div>
</div>
</ng-container>
}
<label igxLabel>Label/Placeholder</label>
</igx-select>
