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
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.
Colapsable
Cómo colapsa: icon (a sólo íconos), offcanvas (se esconde) o none.
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.
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-breakpointdata-ts-persist-keydata-ts-sidebardata-ts-sidebar-collapsibledata-ts-sidebar-drawerdata-ts-sidebar-groupdata-ts-sidebar-group-itemsdata-ts-sidebar-group-toggledata-ts-sidebar-iddata-ts-sidebar-itemdata-ts-sidebar-toggledata-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.csstaisho.button.csstaisho.drawer.csstaisho.icon.csstaisho.menu.csstaisho.modal.csstaisho.separator.csstaisho.spinner.csstaisho.tooltip.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Es un
<nav>conaria-label; el trigger de colapso exponearia-expanded. - Bajo el breakpoint (
data-ts-breakpoint) la barra pasa a un Drawer modal que abre el botón condata-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>conaria-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 untitlecon 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. Concollapsible-offcanvasplegada, el contenido quedainert.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Tab/Enter | En 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.