Formations — 1 037 leçons en français

Accueil › React › Routes imbriquées

Routes imbriquées

Le routeurintermediaire

Une mise en page qui survit aux changements d'écran

const routeur = createBrowserRouter([
  {
    path: "/",
    element: <Cadre />,                       // en-tête + barre latérale
    children: [
      { index: true, element: <Accueil /> },  // "/"
      {
        path: "clients",
        element: <CadreClients />,
        children: [
          { index: true, element: <ListeClients /> },   // "/clients"
          { path: ":id", element: <FicheClient /> },     // "/clients/42"
        ],
      },
      { path: "*", element: <PageIntrouvable /> },
    ],
  },
]);

Les chemins enfants sont relatifs : clients sous / donne /clients. Un chemin enfant commençant par / est une erreur.

Outlet, le trou dans la mise en page

function Cadre() {
  return (
    <div className="cadre">
      <EnTete />
      <main><Outlet /></main>
    </div>
  );
}

Sans Outlet, la route enfant est bien reconnue mais son élément n'a nulle part où apparaître. L'écran semble à moitié chargé, et aucun message n'apparaît : c'est l'erreur la plus fréquente du chapitre.

La route index

{ index: true } décrit ce qu'on affiche quand l'URL s'arrête exactement sur le chemin du parent. Sans elle, /clients rend la barre latérale et un grand blanc.

Ce que l'imbrication apporte

La mise en page n'est pas démontée entre deux écrans enfants : son état, sa position de défilement et ses données chargées survivent. C'est la raison technique de l'imbrication, bien avant l'économie de JSX.

Les termes à connaître

Route de mise en page

Une route dont l'élément contient la structure commune — barre latérale, en-tête — et un Outlet à la place du contenu variable.

Outlet

Le trou dans la mise en page où le routeur rend la route enfant active. Sans lui, les enfants ne s'affichent jamais.

Route index

La route index: true d'un parent : ce qu'on affiche quand l'URL s'arrête exactement sur le chemin du parent.

Route sans chemin

Une route enfant sans path, qui ajoute une mise en page ou un écran d'erreur sans ajouter de segment à l'URL.

Chemin relatif

Un to qui ne commence pas par /. Il se résout contre la route courante, pas contre les segments de l'URL.

Fil d'Ariane

La suite des niveaux traversés, du plus général au plus précis. Elle se déduit de la hiérarchie des routes, pas d'une liste écrite à la main.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.