# Contenido al pasar el cursor o con foco: tooltips correctos

Source: https://allyway.ai/es/glossary/contenido-al-pasar-el-cursor-o-foco

El contenido al pasar el cursor o con foco es el criterio de conformidad WCAG 1.4.13. Cuando el cursor o el foco del teclado hacen aparecer contenido adicional (una descripción emergente personalizada, un submenú o una ventana emergente), este debe poder cerrarse sin mover el cursor ni el foco, poder señalarse con el cursor y mantenerse visible hasta que la persona termine.

El contenido al pasar el cursor o con foco son las [descripciones emergentes](https://allyway.ai/es/glossary/tooltip-accesible), los submenús y las pequeñas ventanas emergentes que aparecen cuando el ratón se detiene sobre un elemento o cuando el foco del teclado llega a él. El criterio WCAG 1.4.13 no los prohíbe, pero fija tres reglas: las personas deben poder cerrarlos, llevar el cursor hasta ellos y leerlos todo el tiempo que necesiten. Sin estas reglas, una descripción emergente puede tapar justo el texto que alguien intenta leer.

## Qué significa

[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) es un criterio de nivel AA de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2). Cuando al recibir y después retirar el cursor o el foco aparece contenido adicional, se aplican las tres condiciones:

| Condición | Requisito | Excepción |
|---|---|---|
| Se puede cerrar | Se puede cerrar sin mover el cursor ni el foco, por ejemplo con la tecla Esc | Muestra un error de entrada o no tapa ningún otro contenido |
| Se puede señalar | Si lo activa el cursor, este puede desplazarse sobre el contenido sin que desaparezca | - |
| Se mantiene | Permanece visible hasta que el cursor o el foco se alejan, la persona lo cierra o su información deja de ser válida | - |

Las descripciones emergentes del navegador creadas con el atributo HTML `title` están exentas: su aspecto lo controla el navegador y no quien crea la página. Las descripciones emergentes personalizadas, los submenús y otras ventanas emergentes no modales sí están incluidos. Un [enlace de salto](https://allyway.ai/es/glossary/enlace-de-salto) que aparece con el foco no está incluido, porque no añade contenido adicional.

Por qué importa: quienes usan una lupa de pantalla se desplazan moviendo el cursor o el foco, así que una descripción emergente que desaparece al mover el cursor es imposible de leer con un zoom del 400 %. Las personas que usan un puntero de ratón grande necesitan llevarlo sobre la descripción para ver lo que el puntero tapa. Las personas con baja visión o con discapacidad cognitiva necesitan tiempo para darse cuenta del contenido nuevo.

> **Tip:** > **Esc es el mecanismo de cierre más sencillo**
> Cierre la ventana emergente cuando se pulse Esc mientras el cursor o el foco siguen donde están. Asegúrese de que el elemento que la activa permanece visible, para que el [foco visible](https://allyway.ai/es/glossary/foco-visible) no quede nunca oculto detrás de la descripción.

## Ejemplos

```html title="Ejemplo"
<button type="button" aria-describedby="tip-vat" class="has-tip">
  Price incl. VAT
</button>
<div role="tooltip" id="tip-vat" class="tip" hidden>
  VAT is calculated from your billing country.
</div>

<script>
  // Show on hover and focus, keep open while the pointer is over the tooltip,
  // close with Escape without moving the pointer or focus.
  document.addEventListener('keydown', (e) => {
    if (e.key === 'Escape') document.getElementById('tip-vat').hidden = true;
  });
</script>
```

La descripción emergente está vinculada con `aria-describedby`, de modo que los lectores de pantalla la leen junto con el botón. Está pegada al botón, sin ningún hueco, así que el cursor puede pasar del elemento que la activa a la descripción sin que esta se cierre.

**Do:** Qué hacer

Cierre las descripciones emergentes y las ventanas emergentes con Esc, no deje ningún espacio entre el elemento que las activa y la descripción, mantenga el contenido abierto mientras el cursor esté sobre él y haga que funcione igual con la [navegación por teclado](https://allyway.ai/es/glossary/navegacion-por-teclado) y con el ratón.

**Don't:** Qué evitar

Ocultar la descripción tras un tiempo fijo, cerrarla en cuanto el cursor sale del elemento que la activa, mostrarla solo al pasar el cursor o dejar que tape el elemento que tiene el foco.

## Cómo comprobar el contenido al pasar el cursor o con foco



## Preguntas frecuentes

Q: ¿Qué significa que se pueda cerrar, señalar y mantener?
A: Se puede cerrar: puede cerrarlo sin mover el cursor ni el foco. Se puede señalar: el cursor puede desplazarse sobre él sin que desaparezca. Se mantiene: permanece hasta que usted se aleja, lo cierra o su información deja de ser válida.

Q: ¿Incumple el atributo title el criterio WCAG 1.4.13?
A: No. Las descripciones emergentes creadas con el atributo `title` las controla el navegador y el W3C las menciona como excepción. Tienen otros problemas (no se muestran con el foco del teclado ni al tocar la pantalla), así que no confíe en ellas para información importante.

Q: ¿Las descripciones emergentes deben cerrarse con la tecla Esc?
A: Las WCAG exigen un mecanismo para cerrarlas sin mover el cursor ni el foco. Esc es la solución habitual y esperada. El contenido que muestra un error de entrada o que no tapa ningún otro contenido no lo necesita.

Q: ¿Los menús que se abren al pasar el cursor están incluidos en el criterio 1.4.13?
A: Sí. El W3C menciona los submenús de forma expresa. Un menú de navegación que se abre al pasar el cursor debe permanecer abierto mientras el cursor se desplaza hacia él y debe cerrarse con Esc si tapa otro contenido.

Q: ¿Cómo puedo probar las descripciones emergentes en muchas páginas?
A: Compruebe cada componente de descripción emergente y de menú una vez en su sistema de diseño o plantilla y después revise algunas páginas por muestreo. El [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) detecta problemas relacionados en el código, como los botones de icono sin nombre.
