# Tooltip accesible: cursor, foco y Escape

Source: https://allyway.ai/es/glossary/tooltip-accesible

Un tooltip accesible es una pequeña ventana emergente con información adicional sobre un elemento que aparece al pasar el ratón y con el foco del teclado, está vinculada a su elemento activador con aria-describedby y cumple el criterio WCAG 1.4.13 Contenido señalado con el puntero o que tiene el foco, de nivel AA: se puede descartar, se puede señalar con el puntero y sigue visible hasta que el usuario se aleja.

Un tooltip accesible es una pequeña burbuja de texto que explica un control («Copiar enlace», «Obligatorio para las facturas», una pista junto a un campo de formulario) y que todos pueden leer y descartar. Muchos tooltips solo se abren al pasar el ratón, desaparecen en cuanto el puntero se mueve hacia ellos o tapan justo el texto que las personas intentan leer. Para los usuarios de teclado, de ampliadores de pantalla y de pantallas táctiles, eso significa que la pista es inalcanzable o estorba.

## Qué significa

Las reglas visuales proceden del criterio [WCAG 1.4.13 Contenido señalado con el puntero o que tiene el foco](https://www.w3.org/WAI/WCAG22/Understanding/content-on-hover-or-focus.html) (nivel AA). Siempre que el paso del cursor o el foco del teclado haga aparecer contenido adicional, se aplican tres condiciones, explicadas con detalle en [contenido al pasar el cursor o con foco](https://allyway.ai/es/glossary/contenido-al-pasar-el-cursor-o-foco):

| Condición | Qué exige |
|---|---|
| Descartable | Los usuarios pueden cerrar el tooltip sin mover el puntero ni el foco, normalmente con Escape, salvo que muestre un error de entrada o no tape otro contenido |
| Señalable con el puntero | Si se abre al pasar el cursor, el puntero puede moverse sobre el tooltip sin que desaparezca |
| Persistente | Sigue visible hasta que el cursor o el foco se alejan, el usuario lo descarta o su información deja de ser válida |

La excepción son los tooltips cuyo aspecto controla el navegador y el autor no modifica. Por eso el atributo nativo `title` queda fuera del criterio 1.4.13, pero solo se muestra al pasar el ratón, no con el foco del teclado ni al tocar la pantalla, de modo que es un mal lugar para la información importante.

En cuanto al código, el [patrón de tooltip](https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/) del W3C describe lo básico (todavía figura como trabajo en curso):

- la ventana emergente tiene `role="tooltip"`
- el elemento activador apunta a ella con `aria-describedby`, de modo que los lectores de pantalla la leen como una descripción
- el foco permanece en el elemento activador: un tooltip nunca recibe el foco
- Escape lo cierra

> **Note:** > **Un tooltip no es un nombre**
> Un botón de icono que solo se explica mediante un tooltip sigue necesitando un [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) propio, por ejemplo un `aria-label`. El tooltip añade una descripción; no sustituye a la etiqueta.

## Ejemplos

```html title="Ejemplo"
<button type="button" aria-label="Copy link"
        aria-describedby="tip-copy">
  <svg aria-hidden="true" focusable="false">…</svg>
</button>
<div role="tooltip" id="tip-copy" hidden>
  Copies the address of this page to your clipboard
</div>
```

El script muestra el tooltip con `mouseenter` y `focus`, lo mantiene abierto mientras el puntero está sobre el botón o sobre el tooltip y lo oculta con `mouseleave`, `blur` y Escape. El [botón de icono](https://allyway.ai/es/glossary/boton-de-icono) tiene su propio nombre, así que un lector de pantalla anuncia «Copy link, botón, Copies the address of this page to your clipboard».

**Do:** Qué hacer

Abra el tooltip al pasar el cursor y con el foco del teclado, deje que Escape lo cierre, manténgalo abierto mientras el puntero está sobre él, colóquelo de forma que no tape el elemento activador y mantenga su texto breve.

**Don't:** Qué evitar

Poner instrucciones esenciales solo en un tooltip, depender del atributo `title` para los usuarios de teclado o de pantalla táctil, cerrarlo tras un tiempo fijo, añadirle enlaces o botones, o usar un tooltip como único nombre de un botón de icono.

Para contenido con enlaces o explicaciones más largas, use un toggletip (un pequeño botón que abre la pista con un clic) o muestre el texto directamente en la página.

## Cómo comprobar un tooltip accesible



## Preguntas frecuentes

Q: ¿Cómo se hace accesible un tooltip?
A: Muéstrelo al pasar el cursor y con el foco del teclado, vincúlelo con `aria-describedby`, dé a la ventana emergente `role="tooltip"`, ciérrelo con Escape y manténgalo abierto mientras el puntero está sobre él. La información importante debe estar en la página, no solo en un tooltip.

Q: ¿Es accesible el atributo title?
A: Queda fuera del criterio WCAG 1.4.13 porque el navegador controla su aspecto. Pero solo aparece al pasar el ratón, así que los usuarios de teclado y de pantalla táctil normalmente no lo ven nunca. No lo use para nada esencial.

Q: ¿Debe un tooltip cerrarse con Escape?
A: Sí. El criterio WCAG 1.4.13 exige una forma de descartar el contenido adicional sin mover el puntero ni el foco, y el patrón de tooltip del W3C usa Escape para ello.

Q: ¿Puede un tooltip contener enlaces o botones?
A: Un tooltip nunca recibe el foco, así que las personas no podrían llegar al contenido interactivo que tuviera. Use en su lugar un toggletip o un cuadro de diálogo no modal.

Q: ¿Cómo funcionan los tooltips en el móvil?
A: En las pantallas táctiles no se puede pasar el cursor por encima. Asegúrese de que la información esté disponible de otra forma: como texto visible o detrás de un botón que la abra al tocarlo.
