Tooltip
Un tooltip muestra información adicional sobre otro componente. La información se muestra encima y cerca del componente de destino.
Uso
Usa un snippet children para recibir los atributos de accesibilidad del tooltip y aplicarlos sobre el elemento de destino. El snippet también recibe un attachment como segundo argumento, que puedes aplicar al elemento que debe actuar como disparador.
<script>
import { Tooltip, Button } from 'fluentui-svelte';
</script>
<Tooltip content="Tooltip content" relationship="description" withArrow>
{#snippet children(attrs)}
<Button {...attrs}>Hover over me</Button>
{/snippet}
</Tooltip> También puedes pasar el elemento de destino directamente como hijo. En ese caso el tooltip se asocia al siguiente elemento renderizado, pero no se aplican los atributos de accesibilidad.
<script>
import { Tooltip, Button } from 'fluentui-svelte';
</script>
<Tooltip content="Tooltip content" relationship="description" withArrow>
<Button>Hover over me</Button>
</Tooltip> API del componente
Una breve explicación de las props que realmente necesitan aclaración. Puedes ver el resto de las props en la sección Propiedades del componente más abajo.
Con flecha
La propiedad withArrow es un booleano que, cuando se establece en true, añade una flecha al tooltip apuntando hacia el elemento de destino. Esto puede ayudar a conectar visualmente el tooltip con el elemento que describe.
Retraso
Las propiedades openDelay y hideDelay te permiten especificar un retraso, en milisegundos, antes de que el tooltip se muestre u oculte después de que el usuario pase el cursor sobre el elemento de destino. Esto puede ayudar a evitar que el tooltip aparezca o desaparezca demasiado rápido.
Propiedades del componente
| Name | Type | Default | Description |
|---|---|---|---|
content | string | Snippet | Component | 'I am a tooltip' | El contenido que se muestra en el tooltip. |
class | string | La clase que se aplica al tooltip. | |
ref bindable | HTMLElement | La referencia DOM del elemento tooltip. | |
target | HTMLElement | El elemento al que se ancla el tooltip. Si no se indica, se usa el contenido renderizado. | |
open bindable | boolean | false | Controla el estado de apertura del tooltip. |
withArrow | boolean | false | Si el tooltip tiene una flecha que apunta a su objetivo. |
positionConfig | ComputePositionConfig | La configuración de posicionamiento que se entrega a floating-ui. | |
openDelay | number | 100 | El retardo en milisegundos antes de mostrar el tooltip. |
hideDelay | number | 300 | El retardo en milisegundos antes de ocultar el tooltip. |
onVisibleChange | (visible: boolean) => void | Función de callback que se llama cuando cambia la visibilidad del tooltip. | |
relationship | 'label' | 'description' | 'inaccessible' | 'label' | La relación del tooltip con su objetivo, que determina cómo se anuncia. |
placement | Placement | Dónde se coloca el tooltip respecto a su objetivo. | |
id | string | El id del elemento tooltip, al que hace referencia el objetivo. Si no se indica, se genera uno. | |
preventClose bindable | boolean | false | Mantiene el tooltip abierto hasta que se cierre a mano. |
animationFrame | boolean | false | Reposiciona el tooltip en cada frame de animación, para un objetivo que no deja de moverse. |
children | Snippet | El objetivo del tooltip. Recibe los atributos ARIA y el attachment que debes aplicar a tu elemento. | |
HTMLAttributes<HTMLDivElement> without children |
