Formations — 1 037 leçons en français

Accueil › Angular › Différer le rendu avec @defer

Différer le rendu avec @defer

Performance et détection de changementsintermediaire

@defer découpe une partie d'un template dans un chunk séparé, téléchargé et rendu seulement quand un déclencheur se produit — pas au chargement du composant qui le contient. Le déclencheur par défaut est on idle (dès que le navigateur est inactif).

@defer (on viewport) {
  <app-avis-clients [produitId]="produit().id" />
} @placeholder {
  <div class="zone-avis">Avis clients</div>
} @loading (minimum 200ms) {
  <app-spinner />
} @error {
  <p>Impossible de charger les avis.</p>
}

Quatre blocs possibles : le contenu principal (obligatoire), @placeholder (avant le déclencheur), @loading (pendant le téléchargement) et @error (si le chargement échoue). Seul le contenu principal est obligatoire, mais un @placeholder est fortement recommandé pour éviter un trou vide dans la page.

Déclencheurs courants : on idle, on viewport (visible à l'écran), on interaction (clic), on hover, on timer(2s), ou when uneCondition() pour une condition personnalisée. prefetch permet de télécharger le chunk en avance tout en retardant son affichage :

@defer (on interaction; prefetch on idle) {
  <app-panneau-filtres />
} @placeholder {
  <button>Filtrer les résultats</button>
}

Effet réel : le code du bloc différé (et ses dépendances propres, si elles ne sont utilisées nulle part ailleurs dans le bundle initial) sort du bundle principal, ce qui réduit le temps de premier affichage — particulièrement utile pour du contenu lourd et non prioritaire (graphiques, cartes, widgets sociaux, commentaires).

Les termes à connaître

@defer

Bloc de contrôle de flux qui découpe le contenu qu'il contient dans un chunk JavaScript séparé, téléchargé et rendu seulement quand un déclencheur se produit, au lieu de faire partie du rendu initial du composant.

@placeholder

Bloc affiché avant que le déclencheur du @defer ne se produise. Optionnel mais fortement recommandé : sans lui, l'emplacement reste simplement vide, ce qui peut provoquer un décalage de mise en page à l'arrivée du contenu.

@loading

Bloc affiché pendant le téléchargement du chunk différé, une fois le déclencheur activé mais avant que le contenu ne soit prêt. Accepte les paramètres minimum (durée d'affichage minimale, évite un flash) et after (délai avant de l'afficher).

@error

Bloc affiché si le chargement du chunk différé échoue (ex. coupure réseau). Sans lui, un échec de chargement laisse simplement le @placeholder affiché.

Déclencheur (on ...)

Condition qui déclenche le passage du @placeholder au chargement : on idle (navigateur inactif, par défaut), on viewport (élément visible à l'écran), on interaction (clic ou touche sur un élément), on hover (survol), on timer(duree), ou when expression (condition personnalisée basée sur un signal ou une autre expression).

prefetch

Mot-clé combinable à un déclencheur (@defer (on interaction; prefetch on idle)) pour télécharger le chunk en avance, avant même que le déclencheur d'affichage ne se produise, tout en retardant son rendu jusqu'à ce déclencheur.

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.