Drawer
Panel que entra desde un borde de la pantalla sin tapar del todo lo de atrás. Para contenido secundario o extenso — filtros, carrito, navegación, detalles — donde conviene no perder el contexto. Mismo motor de <dialog> que Modal.
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.
Panel lateral de filtros
No descartable con nombre propio
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Lado
Desde qué borde de la pantalla entra el panel. Cada uno se abre para verlo.
Tamaño
El ancho (o alto, si entra por arriba/abajo) del panel.
Combinaciones
Lado y tamaño actuando juntos.
Cuándo usarlo
- El contenido es largo o conviene conservar la referencia espacial de dónde salió.
- Filtros, navegación, carrito o un detalle lateral que se abre y se cierra seguido.
- En pantallas chicas, donde un panel de borde a borde rinde más que un cuadro centrado.
Cuándo no
- La tarea es breve y merece el foco pleno de la pantalla →
modal. - Es una confirmación de sí/no →
alert-dialog. - Es sólo un menú de acciones anclado a un disparador →
menuopopover.
Cómo usarlo
- El lado se elige con intención (
side-left,side-right…): navegación al inicio, detalles y filtros al final (respeta RTL). - Conviene darle un encabezado con título y un cierre explícito, además del Escape.
Cómo no usarlo
- La tarea principal de la página no va en un cajón: si es el trabajo central, va en la página.
- No se usa para un aviso pasajero — eso es
toastobanner.
TaishoDS Core
No necesita JavaScript nuestro: lo resuelve el navegador.
Es un <dialog> con invoker commands (commandfor), con transformaciones de CSS para entrar desde el lateral.
Limitación
Sin build, desde el CDN: taisho.drawer.css, además de taisho.base.css. También se carga:
taisho.button.csstaisho.icon.csstaisho.modal.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Modal Dialog de la WAI-ARIA APG.
- Mismo modelo que el Modal:
<dialog>abierto conshowModal()— el navegador aporta el rol de diálogo, atrapa el foco, deja el fondoinerty devuelve el foco 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. - 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. - 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, y el botón × no se muestra. - Con el panel 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. - Vive en el top-layer, sin portal ni
z-index; el deslizamiento entra por@starting-stylesegún el lado (side-left,side-right,side-toposide-bottom).
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 panel. 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.