Escaneo gratis

12 de noviembre de 2026

Ventana modal accesible: el patrón de diálogo modal del W3C paso a paso

Una ventana modal accesible es un diálogo superpuesto a la página, cuyo contenido subyacente queda inerte, y que puede usarse tanto con el teclado como con un producto de apoyo. La guía de prácticas de autoría ARIA del W3C (APG) describe con precisión su comportamiento: al abrirse, el foco se sitúa dentro de la ventana; Tab y Mayús + Tab no permiten salir de ella; la tecla Escape la cierra; al cerrarse, el foco vuelve al elemento que la abrió. En el código, el contenedor lleva el rol dialog, el atributo aria-modal="true" y un nombre accesible. Esta guía repasa esas recomendaciones una por una, con los matices que el W3C añade sobre dónde colocar el foco y cuándo usar aria-modal, y termina con un ejemplo de código que puede adaptar.

¿Qué es una ventana modal accesible según el W3C?

Para la APG, un diálogo es una ventana superpuesta a la ventana principal o a otra ventana de diálogo. Lo que lo hace modal es que las ventanas que quedan debajo son inertes: el usuario no puede interactuar con el contenido situado fuera del diálogo activo.

Ese contenido inerte suele ocultarse visualmente u oscurecerse para que resulte difícil de distinguir. En algunas implementaciones, cualquier intento de interactuar con él cierra el diálogo.

Al igual que los diálogos no modales, los modales contienen su propia secuencia de tabulación. Sin embargo, a diferencia de la mayoría de los diálogos no modales, una ventana modal no ofrece ningún medio para llevar el foco del teclado fuera de ella sin cerrarla. Para un mensaje breve e importante que debe captar la atención del usuario, el W3C prevé un caso especial, el rol alertdialog, descrito en un patrón aparte: el Alert Dialog Pattern.

Foco inicial: ¿dónde colocarlo al abrir la modal?

La regla básica: cuando se abre un diálogo, el foco pasa a un elemento contenido en él. Por lo general, es el primer elemento enfocable. Pero la APG precisa que la ubicación más adecuada depende de la naturaleza y del tamaño del contenido, y menciona varios casos:

Trampa de foco en la modal: Tab, Mayús + Tab y Escape

La APG llama «elemento tabulable» a todo elemento cuyo valor de tabindex es igual o mayor que cero, y advierte que los valores mayores que 0 se desaconsejan firmemente. Con el diálogo abierto, el patrón describe este comportamiento del teclado:

<button type="button" id="open-dialog">Eliminar la cuenta</button>

<div id="dialog" role="dialog" aria-modal="true"
     aria-labelledby="dialog-title" aria-describedby="dialog-desc" hidden>
  <h2 id="dialog-title">¿Eliminar la cuenta?</h2>
  <p id="dialog-desc">Esta acción es definitiva.</p>
  <button type="button" id="cancel">Cancelar</button>
  <button type="button" id="confirm">Eliminar</button>
</div>

<script>
const dialog = document.getElementById('dialog');
const cancel = document.getElementById('cancel');
let opener = null;

function tabbables() {
  return [...dialog.querySelectorAll('a[href], button, input, select, textarea, [tabindex]')]
    .filter(el => !el.disabled && el.tabIndex >= 0);
}

function openDialog(event) {
  opener = event.currentTarget;   // guarda el elemento que abrió el diálogo
  dialog.hidden = false;
  // Para mantener aria-modal="true", el resto de la página debe volverse
  // inerte para todos los usuarios Y quedar visualmente oscurecido (no se muestra aquí).
  cancel.focus();                 // acción menos destructiva
}

function closeDialog() {
  dialog.hidden = true;
  if (opener && opener.isConnected) opener.focus(); // devolución del foco
  else document.querySelector('main h1')?.focus(); // alternativa: un elemento lógico (adáptelo; tabindex="-1" si hace falta)
}

dialog.addEventListener('keydown', (e) => {
  if (e.key === 'Escape') { closeDialog(); return; }
  if (e.key !== 'Tab') return;
  const items = tabbables();
  const first = items[0], last = items[items.length - 1];
  if (e.shiftKey && document.activeElement === first) { e.preventDefault(); last.focus(); }
  else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
});

document.getElementById('open-dialog').addEventListener('click', openDialog);
cancel.addEventListener('click', closeDialog);
</script>

Cierre de la modal: ¿adónde devolver el foco?

Cuando el diálogo se cierra, el foco vuelve al elemento que lo invocó. La APG contempla dos excepciones. La primera: el elemento que lo invocó ya no existe; entonces el foco pasa a otro elemento que ofrezca un flujo de trabajo lógico. La segunda: el diseño del flujo incluye condiciones que a veces hacen más lógico enfocar otro elemento, en concreto cuando es muy poco probable que el usuario necesite volver a abrir el diálogo de inmediato y cuando la tarea realizada en el diálogo está directamente relacionada con el paso siguiente.

El ejemplo del W3C: una cuadrícula tiene una barra de herramientas con un botón para añadir filas. Ese botón «Add Rows» abre un diálogo que pide el número de filas. Al cerrarse, el foco se coloca en la primera celda de la primera fila nueva.

Por último, se recomienda encarecidamente que la secuencia de tabulación de todo diálogo incluya un elemento visible con rol button que cierre el diálogo, como un icono de cierre o un botón Cancelar.

Roles y atributos ARIA de una ventana modal accesible

El patrón del W3C establece los siguientes roles, estados y propiedades:

aria-modal o aria-hidden: las precauciones del W3C

Marcar un diálogo como modal con aria-modal="true" puede impedir que los usuarios de algunos productos de apoyo perciban el contenido situado fuera de él. Si un diálogo se marca como modal pero no se comporta como tal para los demás usuarios, las consecuencias son graves para los usuarios de esos productos de apoyo. Por eso la APG indica que solo se marque como modal cuando se cumplan dos condiciones: el código de la aplicación impide a todos los usuarios interactuar de cualquier forma con el contenido exterior, y el estilo visual oscurece ese contenido.

La propiedad aria-modal, introducida en ARIA 1.1, sustituye a aria-hidden para indicar a los productos de apoyo que el contenido fuera del diálogo es inerte. En implementaciones heredadas que aún usan aria-hidden con este fin, hay dos puntos importantes:

Lista de comprobación para probar su ventana modal accesible

Para revisar una modal existente, recorra los puntos del patrón del W3C uno a uno, primero solo con el teclado y después con un lector de pantalla. El W3C ofrece además dos ejemplos: un ejemplo de diálogo modal con varias capas de diálogos con poco o mucho contenido, y un selector de fecha con una cuadrícula de calendario.

Preguntas frecuentes

¿Cómo hacer accesible una ventana modal?

Según el W3C, lleve el foco al diálogo al abrirlo, haga que Tab y Mayús + Tab den la vuelta dentro de él, ciérrelo con Escape y devuelva el foco al elemento que lo abrió al cerrarlo. El contenedor lleva role="dialog", aria-modal="true" y un nombre accesible mediante aria-labelledby o aria-label.

¿Qué rol ARIA usar en una ventana modal?

El rol dialog en el contenedor. Para un diálogo que desvía la atención del usuario hacia un mensaje breve e importante, el W3C prevé el rol alertdialog, descrito en el Alert Dialog Pattern.

¿Dónde poner el foco al abrir una ventana modal?

Por lo general, en el primer elemento enfocable. Si el contenido es estructurado o largo, se aconseja enfocar un elemento estático con tabindex="-1", al principio del contenido o en la parte superior del diálogo (título, primer párrafo). Antes de una acción difícil de revertir, puede ser aconsejable enfocar la acción menos destructiva.

¿La tecla Escape debe cerrar una ventana modal?

Sí. En el patrón de diálogo modal del W3C, Escape cierra el diálogo. También se recomienda encarecidamente incluir un botón de cierre visible en la secuencia de tabulación.

¿Usar aria-modal o aria-hidden?

aria-modal, introducido en ARIA 1.1, sustituye a aria-hidden para indicar que el contenido exterior es inerte. Marque un diálogo como modal solo si el código impide a todos los usuarios interactuar con el contenido exterior y el estilo visual lo oscurece. En implementaciones heredadas con aria-hidden, ponga aria-hidden="true" en cada elemento de la capa inerte y asegúrese de que el diálogo no sea descendiente de ningún elemento con aria-hidden="true".

¿Adónde vuelve el foco al cerrar una ventana modal?

Al elemento que la abrió. Si ya no existe, el foco pasa a otro elemento que ofrezca un flujo de trabajo lógico. Si el flujo lo justifica (es muy poco probable que haya que reabrirlo de inmediato, tarea directamente ligada al paso siguiente), otro elemento también puede ser más pertinente.

Más sobre el tema en Conformly

Fuentes

Este artículo se basa en las fuentes oficiales citadas al final de la página.