¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 2.4.3Nivel AOperable

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():

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 para ver la regla de preferir el HTML nativo.

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ó.

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

    ¿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.

    • 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 corregirla
    • ARIA: 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 explicados
    • Nombre 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

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo