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: trued'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
toqui 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.
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.