Saltar al contenido principal

wiki-Tooltip

Ver en Git


Tooltip

El componente Tooltip permite posicionar y mostrar un mensaje emergente cerca de un elemento específico. Utiliza efectos y transiciones suaves para aparecer y desaparecer al interactuar con el usuario.

Referencia de la API​

Props​

PropiedadTipoDescripciónValor por defecto
childrenReactNode | stringContenido del elemento principal que activará el tooltip al pasar el cursor sobre él.Requerido
titleReactNode | stringContenido que se mostrará dentro del tooltip.Requerido
aura-teststringIdentificador para pruebas automatizadas.'aura-tooltip'
classNamestringClase CSS personalizada para el tooltip.undefined
styleCSSPropertiesEstilos en línea aplicados al tooltip.undefined
classNameContainerstringClase CSS personalizada para el contenedor principal.undefined

IPosition​

Objeto interno utilizado para determinar la posición del tooltip.

PropiedadTipoDescripción
topstring | numberDistancia desde la parte superior del viewport en píxeles.
bottomstring | numberDistancia desde la parte inferior del viewport en píxeles.
leftstring | numberDistancia desde el lado izquierdo del viewport en píxeles.
rightstring | numberDistancia desde el lado derecho del viewport en píxeles.

Ejemplo de uso​

import { Tooltip } from '@auravant/ui-kit';

<Tooltip
title="Este es un tooltip"
style={{ backgroundColor: 'black', color: 'white' }}
>
<button>Hover para ver el tooltip</button>
</Tooltip>;

Notas​

  • El tooltip calcula automáticamente su posición para evitar desbordar los límites de la ventana.
  • Utiliza transiciones suaves con una duración de 200ms.
  • Puede personalizarse completamente mediante las propiedades className y style.
  • El tooltip se muestra al pasar el cursor sobre el contenedor y desaparece al salir del área.