Saltar al contenido

NavBar

Barra de navegación horizontal: marca al inicio, ítems y acciones. Bajo el breakpoint colapsa detrás de un botón hamburguesa. Los ítems son enlaces con estado activo.

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 de navegación con menú responsive

html

Cuándo usarlo

  • Las secciones principales son pocas y entran en una línea.
  • Se busca la marca, la navegación y las acciones de cuenta en el mismo lugar.
  • El contenido gana con el ancho completo por debajo.

Cuándo no

  • Son muchas secciones y subsecciones (una doc, un panel) → sidebar.
  • Es navegación dentro de una misma página → toc o tabs.

Cómo usarlo

  • Pocos ítems y siempre los mismos: la barra es el mapa estable del sitio.
  • Se marca el ítem activo para que se sepa dónde está parado el usuario.

Cómo no usarlo

  • No se mete ahí toda la navegación de un panel: no entra y se rompe en mobile.
  • No se deja fija (is-sticky) si tapa contenido en pantallas bajas.

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

Decide entre la barra y el menú compacto según el ancho, y abre y cierra ese menú.

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

  • data-ts-toggle
  • data-ts-toggle-escape
  • data-ts-toggle-outside
  • data-ts-toggle-root
  • data-ts-toggle-target

Qué hace: Abre y cierra el menú móvil. El corte responsive puede resolverse por container query, sin JavaScript. Escape cierra el menú (data-ts-toggle-escape) y devuelve el foco al botón si estaba dentro; un puntero presionado fuera de la barra (data-ts-toggle-root) también lo cierra (data-ts-toggle-outside).

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

  • taisho.button.css
  • taisho.icon.css
  • taisho.kbd.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Es un <nav> con nombre accesible; el botón de menú en mobile expone aria-expanded.
  • Con el menú móvil abierto, presionar con el puntero fuera de la barra lo cierra sin mover el foco; presionar dentro de la barra no lo cierra.

Teclado

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

Tecla Qué hace
EscapeCon el menú móvil abierto, lo cierra; si el foco estaba dentro del menú, vuelve al botón de menú.

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.