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
Suspenseau-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.
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.