Saltar al contenido

Tooltip

Etiqueta flotante que aparece al pasar el puntero o enfocar su disparador. El disparador va dentro de un data-ts-tooltip-root, y el texto corto en un elemento data-ts-tooltip con role="tooltip".

Capas flotantes · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Explicación al pasar sobre «Guardar»

Se guarda automáticamente
html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Posición

Posición preferida del tooltip respecto del disparador (se voltea sola si no hay lugar). Cada uno se ve al apuntarlo o enfocarlo.

Producción · Listo Producción · Listo Producción · Listo Producción · Listo
html

Cuándo usarlo

  • Nombrar un control que sólo muestra un ícono.
  • Aclarar un dato o una abreviatura sin ocupar lugar en la interfaz.
  • Lo que dice es un complemento: si no se lee, no se pierde nada.

Cuándo no

  • La información es necesaria para completar la tarea → debe estar visible (por ejemplo la ayuda del campo, ts input-hint).
  • Hay que poder hacer clic dentro → popover.
  • Son acciones sobre un objeto → menu.

Cómo usarlo

  • Texto corto, una línea: es una etiqueta, no documentación.
  • Botón de sólo ícono: además del tooltip, conviene darle su aria-label.

Cómo no usarlo

  • No se esconde ahí lo que el usuario necesita: en touch no hay hover.
  • No se ponen links ni botones adentro — no se pueden alcanzar.

Relacionados

PopoverFieldButton

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

Se muestra con la Popover API, pero el posicionamiento y los retardos son propios del Core.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-placement
  • data-ts-tooltip
  • data-ts-tooltip-root

Qué hace: Retardo de aparición y de desaparición, y posicionamiento. Junto al borde de la ventana deja el mismo margen que la separación con el disparador (6 px).

Sin build, desde el CDN: taisho.tooltip.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Tooltip de la WAI-ARIA APG.

  • Se muestra tanto en hover como en foco de teclado, y se oculta con Escape. Con foco de teclado aparece al instante; con el puntero, a los 150 ms. No hay disparo táctil: un toque puede no mostrarlo, así que nada esencial debe depender de él.
  • El tooltip describe al disparador: al preparar el componente, el Core pone aria-describedby en el primer elemento enfocable de data-ts-tooltip-root (el botón o el enlace), no en el envoltorio. Si no hay ninguno enfocable, queda en el envoltorio y no se garantiza que se anuncie. Sin el JS del Core, el marcado no trae aria-describedby: el tooltip no describe al disparador.
  • Al sacar el puntero, el tooltip espera 100 ms antes de cerrarse y admite el puntero encima, así se puede leer sin que desaparezca (WCAG 1.4.13: descartable y alcanzable). Si el foco sigue en el disparador y el puntero sale, igual se cierra a los 100 ms. Al perder el foco se cierra sin demora.
  • El disparador debe ser un elemento enfocable (botón, link) para que el tooltip sea accesible por teclado.
  • Junto al borde del viewport el tooltip se desplaza para no quedar recortado, con un margen (quarter), así el texto sigue entero y legible en pantallas angostas.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
EscapeCierra el tooltip visible, esté el foco en el disparador o en otro lado. La tecla se consume: un modal o un menú que haya debajo se cierra con el Escape siguiente.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado Mapa de teclas documentado arriba, contrastado contra el componente.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.