Skip to content

Descripción general de Tooltip

El componente Tooltip en App Builder le permite mostrar ayuda contextual o información complementaria cuando los usuarios pasan el cursor o enfocan un elemento de destino en su aplicación. Los tooltips se configuran visualmente a través del panel Properties (Propiedades), y su disparador y contenido se pueden personalizar sin escribir código.

Los tooltips utilizan el componente subyacente Ignite UI Tooltip y generan código limpio específico para Angular, React, Blazor y Web Components.

Características principales

Agregar un Tooltip a un componente

Los tooltips se habilitan directamente desde el panel Properties (Propiedades) del componente de destino. Para adjuntar un tooltip:

  1. Seleccione el componente de destino en el Design Canvas (Lienzo de diseño).
  2. En el panel Properties (Propiedades), desplácese hasta la sección Tooltip.
  3. Active Enable Tooltip (Habilitar Tooltip).
  4. Haga clic en el enlace Edit Tooltip (Editar Tooltip) que aparece para abrir el tooltip y configurar sus propiedades (Target, Mode, Show delay, Hide delay, Arrow).

Alternativamente, puede agregar un Tooltip arrastrándolo desde el Components Toolbox (Cuadro de herramientas de componentes) o utilizando el acceso directo de adición rápida Ctrl+E (⌘+E en Mac) y buscando “Tooltip”.

Contenido del Tooltip

Puede vincular el contenido del tooltip a una variable o a un campo de datos de una fuente de datos conectada, habilitando sugerencias dinámicas y contextuales en tiempo de ejecución.

Retardo de mostrar/ocultar

Controle la capacidad de respuesta de los tooltips configurando:

  • Show delay (Retardo de mostrar) — el tiempo (ms) antes de que aparezca el tooltip después de que el usuario pase el cursor sobre el destino. Por defecto es 300 ms.
  • Hide delay (Retardo de ocultar) — el tiempo (ms) antes de que desaparezca el tooltip después de que el cursor se aleje. Por defecto es 0 ms.

Estos retardos mejoran la usabilidad y evitan el parpadeo de tooltips para los usuarios que mueven rápidamente el cursor entre varios elementos.

Modo

La propiedad Mode (Modo) controla cómo se descarta el tooltip:

  • Default (Predeterminado) — el tooltip aparece al pasar el cursor o enfocar y se descarta automáticamente cuando el cursor o el enfoque se aleja del destino.
  • Sticky (Adhesivo) — el tooltip permanece visible hasta que el usuario lo cierra explícitamente.

Flecha

Active o desactive el indicador de flecha direccional Arrow (Flecha). Cuando está habilitado, una pequeña flecha apunta desde el tooltip hacia su elemento de destino, haciendo que la asociación entre el tooltip y su destino sea visualmente clara.

Disparador de Tooltip

De forma predeterminada, los tooltips se activan al pasar el cursor (mouse) y enfocar (teclado). Este comportamiento dual garantiza el cumplimiento de la accesibilidad con las directrices WCAG.

Propiedades admitidas

PropiedadDescripción
TargetEl componente al que está adjunto el tooltip
ModeCómo se descarta el tooltip: default (automático) o sticky (manual)
Show delayRetardo (ms) antes de que se muestre el tooltip. Por defecto 300
Hide delayRetardo (ms) antes de que se oculte el tooltip. Por defecto 0
ArrowActiva o desactiva el indicador de flecha direccional

Accesibilidad

El componente Tooltip está diseñado teniendo en cuenta la accesibilidad:

  • El elemento de destino recibe aria-describedby que lo vincula al contenido del tooltip.
  • Los tooltips son accesibles por teclado a través de eventos de enfoque.
  • Se proporciona compatibilidad con lectores de pantalla a través de roles ARIA apropiados.

Generación de código

App Builder genera código específico del framework basado en su configuración visual:

  • Angular: Utiliza las directivas igxTooltip e igxTooltipTarget de Ignite UI para Angular.
  • React: Utiliza el componente IgrTooltip de Ignite UI para React.
  • Blazor: Utiliza IgbTooltip de Ignite UI para Blazor.
  • Web Components: Utiliza igc-tooltip de Ignite UI para Web Components.
Note

El contenido del tooltip vinculado a variables o campos de datos se refleja en el código generado como vinculaciones dinámicas específicas de cada framework.

Problemas conocidos y limitaciones

  • Los tooltips anidados no están permitidos.
  • Tooltips repetidos en código generado:
    • Angular ✔️
    • React, Blazor, Web Components 🚧 — el tooltip no se adjunta correctamente al destino repetido.
  • Tooltip en un elemento Select repetido: Los tooltips adjuntos a elementos Select repetidos no funcionan en Angular a menos que el atributo ngProjectAs se agregue al ng-container que envuelve el elemento select. Por ejemplo:
<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 adicionales