Formations — 1 037 leçons en français

Accueil › React › Chargement différé par route

Chargement différé par route

Le routeurintermediaire

Découper par route

Un écran rarement visité n'a pas à être téléchargé au premier chargement. Le bundler découpe à chaque import() dynamique, et la route est la frontière naturelle.

// mode donnée : le routeur attend le module avant de rendre
const routeur = createBrowserRouter([
  {
    path: "/",
    element: <Cadre />,
    children: [
      { index: true, element: <Accueil /> },
      {
        path: "statistiques",
        lazy: async () => {
          const module = await import("./Statistiques");
          return { Component: module.default };
        },
      },
    ],
  },
]);

Pas de Suspense, pas de repli : la navigation reste en attente, l'écran précédent demeure visible, et useNavigation() permet d'afficher une barre de progression.

React.lazy et la place de la frontière

const Statistiques = lazy(() => import("./Statistiques"));

function Cadre() {
  return (
    <div>
      <EnTete />
      <main>
        <Suspense fallback={<Squelette />}>
          <Outlet />
        </Suspense>
      </main>
    </div>
  );
}

La frontière entoure l'Outlet, pas la mise en page. Un Suspense remplace tout son contenu par le repli : placé plus haut, il fait disparaître l'en-tête et la navigation à chaque changement d'écran.

Ce qu'il ne faut pas découper

Le premier écran, la mise en page et le routeur lui-même sont toujours nécessaires. Les mettre dans un fragment ajoute une requête sans rien économiser.

Les termes à connaître

Découpage du code

La séparation du bundle en plusieurs fichiers, chargés à la demande. Le bundler la déclenche sur chaque import() dynamique.

Import dynamique

import("./Fiche"), qui rend une promesse de module. C'est la frontière que le bundler utilise pour découper.

`React.lazy`

Enveloppe un import dynamique en composant. Le premier rendu suspend, et le plus proche Suspense au-dessus affiche son repli.

`Suspense`

La frontière qui affiche un repli pendant qu'un descendant est suspendu. Sa place décide de la zone qui disparaît pendant le chargement.

`lazy` de route

En mode donnée, une fonction par route qui rend le module. Le routeur l'attend avant de rendre : pas de Suspense, et la navigation reste en attente.

Préchargement

Déclencher l'import avant le clic — au survol, ou au repos du navigateur. Le fragment est alors déjà là quand l'utilisateur se décide.

Échec de fragment

Un fragment introuvable, le plus souvent parce qu'un nouveau déploiement a remplacé les fichiers pendant que l'onglet était ouvert.

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.