FRENEnglish version

Navigation dans la page

Minimap

Minimap

Démo

Chargement de la démo…

Une version miniature du document, collée sur le bord : de petits traits remplacent les titres ou les lignes. On voit la forme d'un long contenu d'un coup d'œil et on y saute d'un clic. Au survol, le rail de traits se déplie souvent en sommaire avec les vrais titres.

Histoire

Le saviez-vous

Le mot vient des jeux vidéo : la petite carte dans un coin de l'écran, qui montre tout le niveau et où tu te trouves. Les éditeurs de code ont repris l'idée telle quelle, avec le fichier à la place du niveau et la zone visible à la place du joueur.

Historique

  1. 2010sSublime Text 2 rend la minimap populaire chez les devs.
  2. 2017VS Code 1.10 ajoute une minimap à son éditeur.
  3. 2020sLes outils de notes réduisent le sommaire à un rail de traits qui se déplie au survol.

Vocabulaire

Noms

FR
Minimap, mini-carte, aperçu du document, sommaire flottant, rail de sommaire
EN
Minimap, outline rail, scroll map, document overview, floating table of contents, VS Code minimap

Usages courants

  • Éditeurs de code : vue d'ensemble d'un long fichier
  • Outils de notes et wikis : les titres d'une page en traits sur le bord
  • Docs denses où une colonne de sommaire prendrait trop de place
  • Diffs et logs : repérer d'un coup d'œil les zones modifiées ou en erreur

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="rail">
  <a href="#install" style="--w: 28px"><span>Installation</span></a>
  <a href="#config" style="--w: 18px"><span>Configuration</span></a>
  <a href="#faq" style="--w: 24px"><span>FAQ</span></a>
</nav>

<script>
  const links = document.querySelectorAll('.rail 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>
  .rail { position: fixed; right: 1rem; top: 30%; display: grid; justify-items: end; padding: 6px; border-radius: 8px; }
  .rail a { display: flex; align-items: center; gap: 8px; min-height: 24px; color: inherit; text-decoration: none; }
  .rail a::after { content: ''; width: var(--w); height: 3px; border-radius: 2px; background: currentColor; opacity: 0.4; }
  .rail a[aria-current]::after { opacity: 1; height: 4px; }
  /* Collapsed: the label stays in the DOM (accessible name) but takes no room */
  .rail span { max-width: 0; overflow: hidden; white-space: nowrap; }
  .rail:is(:hover, :focus-within) { background: Canvas; box-shadow: 0 4px 16px rgb(0 0 0 / 0.15); }
  .rail:is(:hover, :focus-within) span { max-width: 12rem; }
</style>

À savoir

  • Deux familles. La minimap d'éditeur (VS Code, Sublime Text) dessine tout le contenu en tout petit. Le rail de traits, façon Notion, ne garde que les titres. Pour une page web, le rail suffit presque toujours.
  • La largeur des traits doit vouloir dire quelque chose : niveau de titre (h2 long, h3 court) ou longueur de la section. Des largeurs au hasard brouillent la lecture.
  • Pour montrer la zone visible (le « slider » des éditeurs) : hauteur = clientHeight / scrollHeight, position = scrollTop / scrollHeight, en pourcentage de la hauteur de la minimap.
  • Pour une vraie miniature du contenu, dessine dans un <canvas> plutôt que de cloner le DOM avec transform: scale(). Le clone double le coût de rendu et duplique les id.

Accessibilité

Prioritaire

  • Chaque trait est un lien qui contient le titre de la section en texte. Replié, cache-le visuellement (max-width: 0, overflow: hidden) mais garde-le dans le DOM : c'est le nom accessible.
  • Déplier le rail au :focus-within autant qu'au :hover, pour que les titres apparaissent aussi au clavier.
  • Le panneau déplié respecte WCAG 1.4.13 : il reste ouvert quand la souris passe dessus, et Échap le referme.

Souvent oublié

  • Un trait fait 3 px de haut, la cible doit en faire au moins 24 (WCAG 2.5.8). Agrandis le lien, pas le trait.
  • Trait actif : aria-current="true", et une différence de forme (plus épais, plus long) en plus de la couleur, contrastée à 3:1 (WCAG 1.4.11).
  • Une minimap dessinée en <canvas> double un contenu déjà lisible : mets-la en aria-hidden="true" pour ne pas l'annoncer deux fois.

Bonus

  • Une option pour masquer la minimap, comme le réglage editor.minimap.enabled de VS Code. Elle occupe de la place et attire l'œil.
  • Pas d'animation de dépliage ni de défilement doux sous prefers-reduced-motion: reduce.

Qui l'utilise