Navigation dans la page
Table des matières sticky
Sticky table of contents
Démo
Chargement de la démo…
La liste des titres de la page, collée sur le côté pendant la lecture, avec la section en cours surlignée. Elle aide à se situer dans une page longue et à sauter directement à une section. Les variantes sans texte ont leur propre fiche : navigation par points, minimap et indicateur de progression de lecture.
Histoire
Le saviez-vous
Le mot « scrollspy » vient d'un plugin jQuery de Bootstrap 2. Le pattern est bien plus vieux, mais c'est ce plugin qui lui a donné le nom que tous les devs cherchent encore sur Google.
Historique
- 1990sLes sommaires à ancres
#sectionexistent dès le HTML des débuts, en haut de page. - 2012Bootstrap 2 sort un plugin Scrollspy et popularise le surlignage automatique.
- 2017+
position: stickydevient utilisable partout, le sommaire passe sur le côté. - 2023Wikipédia en anglais passe à l'habillage Vector 2022 : le sommaire quitte le haut de l'article pour une colonne collée sur le côté.
Vocabulaire
Noms
- FR
- Table des matières sticky, sommaire, sommaire latéral, navigation par ancres, Sur cette page
- EN
- Sticky table of contents, TOC, On this page, scrollspy, anchor navigation, in-page navigation
Usages courants
- Documentation technique et articles longs
- Pages de réglages découpées en sections
- CGU, politiques de confidentialité, contrats
- Specs, RFC et guides de référence
Souvent associé à
Les composants qu'on retrouve avec lui, par type de page, dans l'ordre de lecture.
Article de blog
Voir la maquetteCode
<nav aria-label="On this page" class="toc">
<a href="#install">Installation</a>
<a href="#config">Configuration</a>
<a href="#faq">FAQ</a>
</nav>
<script>
const links = document.querySelectorAll('.toc a')
const io = new IntersectionObserver((entries) => {
for (const e of entries) {
if (!e.isIntersecting) continue
for (const a of links) {
if (a.hash === '#' + e.target.id) a.setAttribute('aria-current', 'true')
else a.removeAttribute('aria-current')
}
}
}, { rootMargin: '0px 0px -70% 0px' })
document.querySelectorAll('section[id]').forEach((s) => io.observe(s))
</script>
<style>
.toc { position: sticky; top: 1rem; }
.toc a[aria-current] { font-weight: 600; }
</style>À savoir
position: stickysuffit pour coller le sommaire, sans JS. Attention : un parent enoverflow: hiddenouautole décolle.- Le scrollspy se fait avec
IntersectionObserver. LerootMarginnégatif en bas (-70%) active une section quand elle passe dans le tiers haut. Observe les sections entières plutôt que les titres : le surlignage reste juste quand on remonte. - Ajoute
scroll-margin-topsur les sections si tu as un header fixe, sinon l'ancre arrive sous le header. - Sous une certaine largeur, la colonne n'a plus sa place. Replie le sommaire dans un
<details>en haut de l'article plutôt que de le supprimer.
Accessibilité
Prioritaire
- Mettre le sommaire dans un
<nav>avecaria-label="Sur cette page", pour le distinguer de la navigation principale. - Marquer le lien actif avec
aria-current="true"(ou"location")."page"désigne une autre page, pas une section. - Utiliser de vrais liens
<a href="#id">: Tab, Entrée, l'URL partageable et le déplacement du focus fonctionnent tout seuls.
Souvent oublié
aria-current=""vautfalse.toggleAttribute('aria-current')ne marque donc rien : écris la valeur"true".- Le lien actif ne doit pas se distinguer que par la couleur : ajoute un filet ou une graisse (WCAG 1.4.1).
- Reprendre le texte exact des titres dans les liens. Un libellé raccourci ou différent désoriente quand on arrive sur la section.
Bonus
- N'activer
scroll-behavior: smoothque sous@media (prefers-reduced-motion: no-preference). - Si tu fais défiler en JS, déplace aussi le focus sur la section (
tabindex="-1"puisfocus({ preventScroll: true })). - Sur un sommaire long, garde le lien actif visible dans la colonne : fais-la défiler elle aussi (
scrollIntoView({ block: 'nearest' })sur le lien).