Saltar al contenido

Toc

Índice “En esta página”: lista de anclas a los headings del contenido, con resaltado de la sección visible (scrollspy). Se renderiza como <nav> con aria-current en el ítem 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.

Índice de un proyecto

Resumen

Panel de control: estado general del proyecto.

Despliegues

Los últimos tres pasaron a Producción sin fallas.

Equipo

Ana Torres, Bruno Díaz y Carla Ruiz trabajan en este proyecto.

html

Cuándo usarlo

  • La página es larga y se lee salteando entre secciones.
  • Los títulos son suficientemente descriptivos como para servir de mapa.
  • Ayuda saber en qué parte del documento se está.

Cuándo no

  • La página es corta: el índice ocupa más de lo que ahorra.
  • Es navegación entre páginas, no dentro de una → sidebar o nav-bar.
  • Son vistas alternativas del mismo bloque → tabs.

Cómo usarlo

  • Se indexa un solo nivel de títulos, o dos como mucho.
  • data-ts-offset se ajusta si hay una barra fija arriba, para que el ancla no quede tapada.

Cómo no usarlo

  • No se lista cada subtítulo: un índice más largo que la sección no es un índice.
  • No se usa para links que salen de la página.

TaishoDS Core

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

Marca la sección que se está leyendo mientras se hace scroll, y eso lo hace el Core.

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

  • data-ts-offset
  • data-ts-scrollspy
  • data-ts-scrollspy-link

Qué hace: Escucha scroll y resize y marca el encabezado activo con aria-current="location". Al llegar al final de la página marca el último.

Sin build, desde el CDN: taisho.toc.css, además de taisho.base.css. Con ese archivo alcanza.

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Es un <nav aria-label>; el ítem de la sección visible lleva aria-current="location".

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 No agrega teclas propias: usa el comportamiento nativo del navegador.
  • 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.