Saltar al contenido

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

html

No descartable con nombre propio

html

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.

html

Tamaño

El ancho (o alto, si entra por arriba/abajo) del panel.

html

Combinaciones

Lado y tamaño actuando juntos.

html

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 → menu o popover.

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 toast o banner.

Relacionados

ModalMenuSidebar

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

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.drawer.css, además de taisho.base.css. También se carga:

  • taisho.button.css
  • taisho.icon.css
  • taisho.modal.css
  • taisho.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 con showModal() — el navegador aporta el rol de diálogo, atrapa el foco, deja el fondo inert y 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> 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.
  • 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, 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-style según el lado (side-left, side-right, side-top o side-bottom).

Teclado

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

Tecla Qué hace
EscapeCierra 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.