# Diálogo modal accesible: foco, Escape y ARIA

Source: https://allyway.ai/es/glossary/dialogo-modal-accesible

Un diálogo modal accesible es una ventana emergente que los usuarios de teclado y de lector de pantalla pueden utilizar igual que los demás: el foco pasa a ella al abrirse, la página de fondo queda inerte, Escape la cierra y el foco vuelve al control que la abrió. Su gestión del foco entra en el criterio WCAG 2.4.3 Orden del foco, de nivel A.

Un diálogo modal accesible es una ventana emergente (una ventana de inicio de sesión, una invitación a suscribirse al boletín, una «vista rápida» en una tienda) que funciona para quienes no usan ratón. Muchos diálogos se abren visualmente, pero dejan el foco del teclado en la página de fondo: los usuarios de teclado recorren con Tab enlaces ocultos mientras el diálogo espera encima, y los usuarios de lector de pantalla nunca se enteran de que ha aparecido. Gestionar bien el foco es la mayor parte del trabajo.

## Qué significa

Un diálogo modal se apodera de la página hasta que se cierra. El W3C lo utiliza como ejemplo del criterio [WCAG 2.4.3 Orden del foco](https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html) (nivel A): al activar el botón que lo invoca, el diálogo se abre y el foco se sitúa en su interior; mientras está abierto, el contenido exterior está inerte y no puede recibir el foco; al cerrarlo, el foco vuelve al botón que lo invocó o al elemento siguiente. El W3C recoge el elemento HTML `dialog` como técnica H102, y el fallo F85 describe los diálogos que no están junto a su botón en el orden de navegación.

El patrón de [diálogo (modal)](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/) de la guía WAI-ARIA Authoring Practices añade el comportamiento de teclado y el marcado esperados:

| Elemento | Comportamiento esperado |
|---|---|
| Apertura | El foco pasa a un elemento del diálogo, normalmente el primero que puede recibirlo |
| Tab / Mayús+Tab | El foco recorre el interior del diálogo y salta del último elemento al primero |
| Escape | Cierra el diálogo |
| Cierre | El foco vuelve al elemento que lo abrió |
| `role="dialog"` | En el contenedor; `alertdialog` para mensajes breves y urgentes |
| `aria-modal="true"` | Indica a la tecnología de apoyo que el contenido de fondo está inerte |
| `aria-labelledby` | Apunta al título visible del diálogo y le da un [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) |

> **Note:** > **Mantener el foco dentro no es una trampa de teclado**
> Que Tab se quede dentro de un diálogo abierto es lo previsto. Solo se convierte en una [trampa de teclado](https://allyway.ai/es/glossary/trampa-de-teclado) si los usuarios no pueden salir de él, y por eso son importantes Escape y un botón de cierre visible.

## Ejemplos

El elemento nativo `dialog` se encarga de la mayor parte de esto cuando se abre con `showModal()`:

```html title="Ejemplo"
<button type="button" id="open">Sign up for our newsletter</button>

<dialog id="newsletter" aria-labelledby="nl-title">
  <h2 id="nl-title">Newsletter</h2>
  <form method="dialog">
    <label for="nl-email">Email address</label>
    <input id="nl-email" type="email" autocomplete="email">
    <button value="ok">Subscribe</button>
    <button value="cancel">Close</button>
  </form>
</dialog>

<script>
  const dialog = document.getElementById('newsletter');
  const opener = document.getElementById('open');
  opener.addEventListener('click', () => dialog.showModal());
  dialog.addEventListener('close', () => opener.focus());
</script>
```

`showModal()` deja inerte el resto de la página, lleva el foco al diálogo y lo cierra con Escape. El controlador del evento `close` devuelve el foco al botón, como describe el W3C. Si construye un diálogo a partir de un `div`, tendrá que añadir usted mismo `role="dialog"`, `aria-modal="true"`, el bucle de foco y la gestión de Escape; consulte [ARIA](https://allyway.ai/es/glossary/aria) para ver la regla de preferir el HTML nativo.

**Do:** Qué hacer

Lleve el foco al diálogo, dele un título visible vinculado con `aria-labelledby`, ciérrelo con Escape y con un botón de cierre con etiqueta, mantenga inerte la página de fondo y devuelva el foco al botón que lo abrió.

**Don't:** Qué evitar

Abrir un diálogo sin mover el foco, dejar que Tab se vaya a la página de fondo, usar un botón de cierre solo con icono y sin nombre, abrirlo automáticamente al cargar la página, o dejar el foco al principio de la página después de cerrarlo.

## Cómo comprobar un diálogo modal accesible



## Preguntas frecuentes

Q: ¿Qué hace accesible un diálogo modal?
A: El foco pasa a él al abrirse, la página de fondo queda inerte, con Tab el foco no sale de él, Escape lo cierra y después el foco vuelve al botón que lo abrió. También necesita un título visible que lo nombre para los lectores de pantalla.

Q: ¿Debo usar el elemento dialog de HTML o ARIA?
A: Prefiera el elemento nativo `dialog` abierto con `showModal()`: el W3C lo recoge como técnica H102 para el criterio WCAG 2.4.3. Cree un diálogo personalizado con un `div`, con `role="dialog"` y `aria-modal="true"`, solo si no puede usar el elemento nativo.

Q: ¿Adónde debe ir el foco cuando se abre un diálogo?
A: Según la guía WAI-ARIA Authoring Practices, normalmente al primer elemento del diálogo que puede recibir el foco. Si el contenido es largo, el título o el principio del contenido pueden ser un mejor destino, para que los usuarios no se pierdan lo que viene primero.

Q: ¿Se permite atrapar el foco en un modal?
A: Sí, mientras el diálogo está abierto. El propio ejemplo del W3C para el criterio 2.4.3 deja inerte el contenido exterior. Eso sí, debe ser fácil salir: Escape y un botón de cierre con etiqueta evitan que se convierta en una trampa de teclado.

Q: ¿Qué criterios WCAG se aplican a los diálogos modales?
A: Principalmente el 2.4.3 Orden del foco y el 2.1.1 Teclado, además del 4.1.2 Nombre, función, valor para el rol y el nombre del diálogo, y el 2.1.2 Sin trampas para el foco del teclado. Todos son de nivel A en las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2).
