Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

aria-modal — semántica de los diálogos modales

El atributo aria-modal indica a las tecnologías de asistencia si un elemento mostrado es modal, es decir, si la interacción queda restringida a su contenido. Por sí solo no bloquea el fondo ni gestiona el foco: la declaración debe coincidir con el comportamiento real de la interfaz.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

aria-modal="true" | aria-modal="false"

aria-modal es una propiedad WAI-ARIA usada en HTML para indicar si un elemento mostrado es modal. El valor true indica modalidad; false es el valor predeterminado. Esta propiedad acepta los valores de texto true y false, y no sigue la sintaxis de los atributos booleanos de HTML: no escribas el nombre del atributo sin un valor. Se admite en los roles dialog y alertdialog, no de forma global en elementos arbitrarios.

aria-modal="true" comunica semántica a las tecnologías de asistencia, que pueden restringir la navegación al contenido del diálogo. No abre un diálogo, no bloquea los clics en el fondo ni mueve o mantiene el foco. Establece este valor solo cuando la interfaz impide realmente que todas las personas interactúen con el contenido exterior al diálogo y el fondo está atenuado u oculto visualmente.

Al abrirlo, mueve el foco al interior del diálogo y mantén dentro la secuencia de Tab y Shift+Tab. Incluye un botón de cierre dentro y admite Escape; al cerrarlo, normalmente devuelve el foco al elemento que lo activó. Asigna al diálogo un nombre accesible, por ejemplo mediante aria-labelledby que haga referencia a su encabezado visible. Todos los controles necesarios para utilizar el diálogo deben ser descendientes suyos.

El ejemplo usa un diálogo nativo abierto con showModal(), en lugar de recrear manualmente el comportamiento modal. En este caso, aria-modal="true" es redundante porque la modalidad nativa ya se expone a las tecnologías de asistencia; se mantiene para mostrar la sintaxis. Añadir el atributo por sí solo a un contenedor corriente no proporciona este comportamiento. Comprueba por separado el funcionamiento con teclado y la semántica en el árbol de accesibilidad.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Resultado

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes