Formations — 1 037 leçons en français

Accueil › React › Routes et liens

Routes et liens

Le routeurintermediaire

Déclarer les routes

import { createBrowserRouter, RouterProvider } from "react-router";

const routeur = createBrowserRouter([
  { path: "/", element: <Accueil /> },
  { path: "/clients", element: <ListeClients /> },
  { path: "/clients/:id", element: <FicheClient /> },
  { path: "*", element: <PageIntrouvable /> },
]);

createRoot(document.getElementById("racine")).render(
  <RouterProvider router={routeur} />
);

Une route associe un motif de chemin à un élément. /clients/:id décrit toutes les fiches clients, pas une seule.

Naviguer sans recharger

import { Link, NavLink } from "react-router";

<Link to="/clients">Clients</Link>

<NavLink to="/" end className={({ isActive }) => (isActive ? "actif" : "")}>
  Accueil
</NavLink>

Link rend un vrai <a href> — le clic droit, le survol et l'ouverture dans un onglet fonctionnent — mais il intercepte le clic gauche et remplace l'écran en mémoire. Un <a href> écrit à la main recharge toute l'application.

NavLink ajoute l'état actif. Sans end, to="/" est actif sur toutes les URL, puisque / les préfixe toutes.

Naviguer depuis du code

const naviguer = useNavigate();

function enregistrer() {
  // ... puis on quitte le formulaire
  naviguer("/clients", { replace: true });
}

replace: true écrase l'entrée courante au lieu d'en ajouter une : après l'enregistrement, le bouton Retour ne ramène pas sur le formulaire envoyé.

Les termes à connaître

Routeur

La pièce qui lit l'URL et décide quel composant afficher. Dans une application d'une seule page, c'est du code JavaScript : le serveur n'est plus consulté à chaque changement d'écran.

Route

L'association d'un motif de chemin et d'un composant. /clients/:id décrit une famille d'URL, pas une seule.

Historique

La pile des entrées de navigation du navigateur. Le routeur l'écrit avec pushState ou replaceState, ce qui change l'URL sans recharger la page.

Navigation côté client

Changer d'écran en remplaçant une partie de l'arbre React, sans requête HTML. C'est ce que fait Link et que ne fait pas <a href>.

Route attrape-tout

La route de motif *, retenue quand aucune autre ne correspond. C'est l'écran 404 de l'application.

Mode déclaratif

<BrowserRouter> avec des éléments <Routes> et <Route> écrits dans le JSX. Le mode donnée décrit les mêmes routes dans un tableau d'objets passé à createBrowserRouter.

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.