FRENEnglish version

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

  1. 1990sLes sommaires à ancres #section existent dès le HTML des débuts, en haut de page.
  2. 2012Bootstrap 2 sort un plugin Scrollspy et popularise le surlignage automatique.
  3. 2017+position: sticky devient utilisable partout, le sommaire passe sur le côté.
  4. 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.

Code

<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: sticky suffit pour coller le sommaire, sans JS. Attention : un parent en overflow: hidden ou auto le décolle.
  • Le scrollspy se fait avec IntersectionObserver. Le rootMargin né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-top sur 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> avec aria-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="" vaut false. 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: smooth que sous @media (prefers-reduced-motion: no-preference).
  • Si tu fais défiler en JS, déplace aussi le focus sur la section (tabindex="-1" puis focus({ 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).

Qui l'utilise