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:
- Seleccione el componente de destino en el Design Canvas (Lienzo de diseño).
- En el panel Properties (Propiedades), desplácese hasta la sección Tooltip.
- Active Enable Tooltip (Habilitar Tooltip).
- 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
| Propiedad | Descripción |
|---|---|
| Target | El componente al que está adjunto el tooltip |
| Mode | Cómo se descarta el tooltip: default (automático) o sticky (manual) |
| Show delay | Retardo (ms) antes de que se muestre el tooltip. Por defecto 300 |
| Hide delay | Retardo (ms) antes de que se oculte el tooltip. Por defecto 0 |
| Arrow | Activa 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-describedbyque 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
igxTooltipeigxTooltipTargetde Ignite UI para Angular. - React: Utiliza el componente
IgrTooltipde Ignite UI para React. - Blazor: Utiliza
IgbTooltipde Ignite UI para Blazor. - Web Components: Utiliza
igc-tooltipde 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
ngProjectAsse agregue alng-containerque 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>
