Diálogo modal accesible: foco, Escape y ARIA
También llamado: Modal accesible, Ventana emergente accesible, Ventana de diálogo
Definición
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 (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) 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 |
Ejemplos
El elemento nativo dialog se encarga de la mayor parte de esto cuando se abre con showModal():
<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 para ver la regla de preferir el HTML nativo.
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ó.
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
¿Qué hace accesible un diálogo modal?
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.
¿Debo usar el elemento dialog de HTML o ARIA?
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.
¿Adónde debe ir el foco cuando se abre un diálogo?
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.
¿Se permite atrapar el foco en un modal?
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.
¿Qué criterios WCAG se aplican a los diálogos modales?
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.
Términos relacionados
Orden del foco: orden de tabulación lógico (WCAG 2.4.3)
El orden del foco es la secuencia en la que los elementos interactivos reciben el foco del teclado cuando el usuario pulsa Tab. El criterio WCAG 2.4.3 exige que esta secuencia preserve el significado y la operabilidad de la página.
Leer la definición: Orden del foco: orden de tabulación lógico (WCAG 2.4.3)Trampa de teclado (WCAG 2.1.2): qué es y cómo corregirla
Una trampa de teclado es una parte de la página en la que el foco del teclado puede entrar, pero de la que no puede salir usando solo el teclado. El criterio WCAG 2.1.2 Sin trampas para el foco del teclado la prohíbe en el nivel A.
Leer la definición: Trampa de teclado (WCAG 2.1.2): qué es y cómo corregirlaARIA: roles, estados y propiedades explicados
ARIA (WAI-ARIA, Accessible Rich Internet Applications) es una especificación del W3C de atributos HTML (roles, estados y propiedades) que indican a las tecnologías de apoyo qué es un elemento personalizado, cómo se llama y en qué estado se encuentra.
Leer la definición: ARIA: roles, estados y propiedades explicadosNombre accesible: qué es y cómo se calcula
El nombre accesible es el texto que los navegadores transmiten a las tecnologías de apoyo para identificar un elemento, por ejemplo las palabras que un lector de pantalla anuncia para un botón, un enlace o un campo de formulario. El criterio WCAG 4.1.2 exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software.
Leer la definición: Nombre accesible: qué es y cómo se calcula