---
title: "Navigation et onglets"
description: "Comment les front-matter tab, group et order assemblent la barre latérale de la documentation."
tab: "Documentation"
group: "Configuration"
order: 2
icon: "list"
updated: "2026-07-11"
---

Chaque page déclare sa propre place dans la barre latérale via ses front-matter `tab`, `group` et
`order`. Les options `tabs` et `groups` de l'instance `Docs` déterminent, elles, l'ordre et les
libellés des sections.

## Placer une page dans un onglet

Le `tab` d'une page la place sous une section de premier niveau. Avec plusieurs onglets, une barre
d'onglets apparaît au-dessus de la barre latérale ; avec un seul onglet, elle est masquée.

## Regrouper les pages dans la barre latérale

Les pages partageant un même `group` sont listées ensemble sous un intitulé en majuscules. Les pages
sans `group` tombent dans un ensemble sans étiquette.

`tab` et `group` sont comparés comme des chaînes exactes : `"Get started"` et `"Get Started"` sont
donc deux sections distinctes.

## Ordonner les sections

Les onglets et les groupes sont triés selon leur position dans les tableaux `tabs` et `groups` de
l'instance `Docs`. Un onglet ou un groupe absent de ces tableaux est trié après tous ceux qui y
figurent : listez-les donc tous.

```ts
export const docs = new Docs({
  contentDir: "./docs",
  tabs: ["Documentation", "Guides"],
  groups: ["Get started", "Configuration", "Recipes"],
});
```

Passez `{ id, label }` au lieu d'une simple chaîne pour renommer une section dans l'interface sans
modifier une seule page.

## Ordonner les pages dans un groupe

`order` trie les pages au sein de leur groupe, par ordre croissant. Une page sans `order` est triée
après toutes les pages ordonnées, et deux pages dépourvues d'`order` conservent simplement l'ordre
dans lequel elles ont été lues sur le disque. Deux pages partageant le même `order` sont départagées
par ordre alphabétique de `title`.

Donnez donc à chaque page d'un groupe son propre `order`, dense à partir de 1, si vous voulez que la
barre latérale se lise comme vous l'avez écrite.

`order` doit être un **nombre nu**. Entre guillemets (`order: "3"`), il est silencieusement ignoré :
la page continue de s'afficher, mais elle tombe dans l'ensemble non ordonné, en bas de son groupe.

## Masquer une page de la navigation

Définissez `hidden: true` pour garder une page accessible par route tout en la retirant de la barre
latérale, de la navigation précédent/suivant, de l'index et du sitemap. Une page masquée est servie
avec `robots: noindex` et n'a ni fil d'Ariane ni précédent/suivant : elle n'est atteignable que par
un lien direct. Pratique pour les brouillons et les liens profonds.

`hidden` doit être un **booléen nu**. `hidden: "true"` est une chaîne, silencieusement ignorée, et le
brouillon reste publiquement navigable.