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.
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 →
sidebaronav-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-offsetse 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.
Relacionados
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-offsetdata-ts-scrollspydata-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 llevaaria-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.