Skip to content

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:

  1. Selecione o componente alvo na Tela de Design.
  2. No painel Propriedades, role até a seção Tooltip.
  3. Ative Ativar Tooltip.
  4. 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

PropriedadeDescrição
AlvoO componente ao qual o tooltip está anexado
ModoComo o tooltip é descartado: padrão (automático) ou fixo (manual)
Atraso de exibiçãoAtraso (ms) antes do tooltip ser mostrado. Padrão é 300
Atraso de ocultaçãoAtraso (ms) antes do tooltip ser ocultado. Padrão é 0
SetaAlterna 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-describedby vinculando-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 igxTooltip e igxTooltipTarget do Ignite UI para Angular.
  • React: Usa o componente IgrTooltip do Ignite UI para React.
  • Blazor: Usa IgbTooltip do Ignite UI para Blazor.
  • Web Components: Usa igc-tooltip do 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 ngProjectAs seja adicionado ao ng-container que 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>

Recursos Adicionais