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
@deferne 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) etafter(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
@placeholderaffiché.- Déclencheur (on ...)
Condition qui déclenche le passage du
@placeholderau 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), ouwhen 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.
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.