Saltar al contenido

Sidebar

Navegación lateral persistente. Colapsa a un rail de íconos o se esconde del todo, recuerda su estado y bajo lg se convierte sola en un Drawer. Atajo ⌘/Ctrl + B.

Navegación · 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.

Barra lateral con grupos colapsables

html

Referencia de clases

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

Lado

De qué lado vive la barra: side-left o side-right.

html

Colapsable

Cómo colapsa: icon (a sólo íconos), offcanvas (se esconde) o none.

html

Cuándo usarlo

  • Hay muchas secciones, con jerarquía, y conviene tenerlas siempre a la vista.
  • El usuario salta seguido entre secciones (docs, panel de administración).
  • Se busca que en pantallas chicas la misma navegación se vuelva un panel.

Cuándo no

  • Las secciones son pocas y entran arriba → nav-bar.
  • Es el índice de la página que se está leyendo → toc.
  • Es un panel temporal que se abre y se cierra → drawer.

Cómo usarlo

  • Los ítems se agrupan por tema y se marca el activo.
  • Conviene dejarla colapsar: en pantallas chicas el contenido vale más que el menú.
  • En el rail colapsado, los ítems de un grupo desplegado quedan como íconos: conviene que cada ítem lleve el suyo. Un grupo plegado no se alcanza hasta expandir la barra.

Cómo no usarlo

  • No se anidan tres niveles de menús: se vuelve un laberinto.
  • No se duplica ahí lo que ya está en la barra superior.

Relacionados

NavBarDrawerToc

TaishoDS Core

Necesita el JS del Core: maneja foco, teclado y estado.

Es un conjunto de piezas (barra, grupos, ítems, disparador) que se coordinan entre sí.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-breakpoint
  • data-ts-persist-key
  • data-ts-sidebar
  • data-ts-sidebar-collapsible
  • data-ts-sidebar-drawer
  • data-ts-sidebar-group
  • data-ts-sidebar-group-items
  • data-ts-sidebar-group-toggle
  • data-ts-sidebar-id
  • data-ts-sidebar-item
  • data-ts-sidebar-toggle
  • data-ts-sidebar-trigger

Qué hace: Colapsa y expande con persistencia, soporta grupos anidados y marca el ítem activo. Bajo el breakpoint (data-ts-breakpoint, por @media) la barra se esconde y el HTML trae el Drawer con la misma navegación: el disparador (data-ts-sidebar-trigger) lo abre en ventana angosta y colapsa la barra en ventana ancha. Si se agranda la ventana con el Drawer abierto, se cierra y el foco vuelve al disparador.

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

  • taisho.badge.css
  • taisho.button.css
  • taisho.drawer.css
  • taisho.icon.css
  • taisho.menu.css
  • taisho.modal.css
  • taisho.separator.css
  • taisho.spinner.css
  • taisho.tooltip.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Es un <nav> con aria-label; el trigger de colapso expone aria-expanded.
  • Bajo el breakpoint (data-ts-breakpoint) la barra pasa a un Drawer modal que abre el botón con data-ts-sidebar-trigger; la navegación conserva su <nav aria-label> adentro, y el Drawer lleva ese mismo nombre como título visible (el <h2> que nombra al <dialog> con aria-labelledby), con su botón de cierre. Sin un disparador visible en la página, en pantallas angostas no hay cómo abrirla (a 320px el contenido no puede compartir el ancho con una barra de 256px: WCAG 1.4.10). Activar un ítem cierra el Drawer y Escape lo cierra devolviendo el foco al disparador. Si se agranda la ventana por encima del breakpoint con el Drawer abierto, también se cierra (ya hay lugar para la barra fija) y el foco vuelve al disparador en vez de perderse; al achicar de nuevo, el Drawer no reaparece abierto.
  • El ítem activo se trae a la vista scrolleando la barra a mano y no con scrollIntoView, que en Chrome mueve el punto de partida del Tab y saltea todo lo anterior al ítem activo.
  • Rail colapsado (collapsible-icon): los ítems quedan como ícono y siguen siendo operables. Cada uno conserva su nombre accesible, porque la etiqueta queda dentro del enlace con el texto visualmente oculto, y lleva un title con ese nombre. No hay flyout de grupo: los ítems de un grupo desplegado siguen en el rail como íconos, y un grupo plegado queda fuera del recorrido hasta expandir la barra. Con collapsible-offcanvas plegada, el contenido queda inert.

Teclado

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

Tecla Qué hace
Tab/EnterEn el rail colapsado, Tab recorre los ítems en forma de ícono y Enter activa el enfocado.

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.