Saltar al contenido

Modal

Diálogo centrado que interrumpe para una tarea acotada — un formulario, un detalle, una confirmación liviana. Monta sobre <dialog> nativo: atrapa el foco, cierra con Escape y el fondo queda inerte.

Capas flotantes · TaishoDS Core, en HTML plano.

Ejemplos

Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.

Confirmación con acciones

html

Modal con foco inicial, hoja en pantallas chicas

html

Header propio con nombre accesible

html

No descartable

html

Referencia de clases

Todos los valores de cada modificador, con su HTML listo para copiar.

Tamaño

El ancho del panel: sm, md o lg. Cada uno se abre para verlo.

html

Adaptable

responsive-sheet: bajo 640px de ventana el panel se vuelve una hoja inferior a todo el ancho.

html

Botón de cerrar

Sin showClose el header no lleva la X; se cierra con Escape, el fondo o un botón propio.

html

Pie

El pie con acciones queda fijo debajo del cuerpo.

html

Cuándo usarlo

  • La tarea es autocontenida y corta: cabe sin scroll y se resuelve sin salir.
  • Interrumpir el flujo está justificado: lo que hay abajo puede esperar.
  • Alcanza con que el usuario pueda cerrar tocando el fondo o con Escape.

Cuándo no

  • La decisión es destructiva o irreversible y no puede cerrarse sin querer → alert-dialog.
  • El contenido es largo, secundario o conviene conservar el contexto de al lado (filtros, carrito, navegación) → drawer.
  • Es un aviso que no exige respuesta inmediata → banner o note en la propia página.

Cómo usarlo

  • Conviene darle un título visible: es el nombre accesible del diálogo y el ancla a la que llega quien lo abre. Con un header propio, el nombre lo da aria-labelledby (hacia su título) o aria-label.
  • Una sola tarea por modal. Si aparece un segundo paso, conviene replantear el flujo antes que anidar.
  • Si hay un campo que el usuario va a completar primero, conviene darle autofocus: showModal() lo enfoca al abrir, en cada apertura.
  • En pantallas chicas, la clase responsive-sheet en el <dialog> lo convierte en una hoja inferior más cómoda de alcanzar con el pulgar.

Cómo no usarlo

  • No se abre un modal desde otro modal: apilar top-layers confunde el foco y el Escape.
  • No se usa para confirmaciones que exigen elegir sí o no — para eso el fondo NO debe descartar.

TaishoDS Core

No necesita JavaScript nuestro: lo resuelve el navegador.

Es un <dialog> con invoker commands (commandfor): abre, cierra, atrapa el foco y pinta el fondo sin una línea de JavaScript (en un navegador con invoker commands).

Limitación

El disparador usa invoker commands (`command` y `commandfor`), que el navegador trae desde Chrome 135, Firefox 144 y Safari 26.2. En los anteriores el JS del Core ejecuta los comandos sobre el dialog; si no se cargó ese JS, el botón no abre y hay que abrirlo con `dialog.showModal()` desde tu código.

Sin build, desde el CDN: taisho.modal.css, además de taisho.base.css. También se carga:

  • taisho.button.css
  • taisho.icon.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Modal Dialog de la WAI-ARIA APG.

  • Elemento <dialog> abierto con showModal(): el navegador aporta el rol de diálogo, atrapa el foco y lo devuelve al trigger al cerrar. En WebKit, si el diálogo se abrió con el mouse, al cerrar el foco no vuelve al disparador: Safari no enfoca un botón al hacerle clic.
  • El fondo queda inert de forma nativa: los lectores de pantalla y el foco no alcanzan el contenido detrás del modal.
  • Nombre accesible: con el título del componente, el <dialog> lleva aria-labelledby hacia él. Con un encabezado propio hay que dar el nombre con aria-labelledby (hacia el título del header) o aria-label en el <dialog>; sin ninguno (un atributo title también cuenta como nombre), el Core lo avisa por la consola cuando la página se sirve desde localhost.
  • Escape cierra el diálogo, salvo que no sea descartable; el botón × expone aria-label y no se muestra si no es descartable.
  • No descartable: closedby="none" en el <dialog>. El navegador no lo cierra con Escape ni con el fondo; donde no lo honra, el evento cancel y el Escape del teclado se previenen. Sólo cierran sus propios botones.
  • Con el diálogo abierto, la página de atrás no se desplaza y conserva el lugar de la barra de desplazamiento (scrollbar-gutter: stable), así que el contenido no se corre.
  • Foco inicial: el navegador enfoca el hijo con autofocus (o, si no hay, el primer control) en cada showModal(); no hace falta JS.
  • responsive-sheet sólo cambia la posición y la animación bajo 640px: el rol, el foco atrapado y el Escape son los mismos.
  • Vive en el top-layer del navegador, por lo que no lo afecta el overflow ni el z-index de sus ancestros.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
EscapeCierra el diálogo. Si no es descartable (closedby="none"), no hace nada, tampoco al segundo Escape seguido.

Verificación

Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.

  • axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
  • teclado Mapa de teclas documentado arriba, contrastado contra el componente.
  • lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.