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
Modal con foco inicial, hoja en pantallas chicas
Header propio con nombre accesible
No descartable
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.
Adaptable
responsive-sheet: bajo 640px de ventana el panel se vuelve una hoja inferior a todo el ancho.
Botón de cerrar
Sin showClose el header no lleva la X; se cierra con Escape, el fondo o un botón propio.
Pie
El pie con acciones queda fijo debajo del cuerpo.
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 →
banneronoteen 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
headerpropio, el nombre lo daaria-labelledby(hacia su título) oaria-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-sheeten 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.
Relacionados
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
Sin build, desde el CDN: taisho.modal.css, además de taisho.base.css. También se carga:
taisho.button.csstaisho.icon.csstaisho.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 conshowModal(): 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
inertde 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>llevaaria-labelledbyhacia él. Con un encabezado propio hay que dar el nombre conaria-labelledby(hacia el título del header) oaria-labelen el<dialog>; sin ninguno (un atributotitletambién cuenta como nombre), el Core lo avisa por la consola cuando la página se sirve desdelocalhost. - Escape cierra el diálogo, salvo que no sea descartable; el botón × expone
aria-labely 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 eventocancely 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 cadashowModal(); no hace falta JS. responsive-sheetsó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
overflowni elz-indexde sus ancestros.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Escape | Cierra 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.