Accueil › Angular › Hydratation incrémentale
Hydratation incrémentale
SSR, hydratation et SEOavance
L'hydratation (leçon précédente) réutilise le DOM du SSR au lieu de le recréer, mais elle le fait d'un coup, pour toute la page, au démarrage. Sur une page riche en widgets secondaires (avis clients, produits recommandés, chat d'assistance…), ce travail d'hydratation complète — attacher tous les gestionnaires d'événements, reconstruire tout l'état interne — peut retarder inutilement le moment où l'essentiel de la page devient réellement interactif.
L'hydratation incrémentale répartit ce travail bloc par bloc, en réutilisant la syntaxe @defer déjà connue pour le chargement paresseux de sous-arbres, en lui ajoutant un déclencheur d'hydratation séparé par un point-virgule :
@defer (on viewport; hydrate on interaction) {
<app-avis-clients [produitId]="produit().id" />
} @placeholder {
<div>Avis clients</div>
}
Le contenu de ce bloc est présent dans le HTML dès le rendu serveur (visible, lisible, indexable), mais il ne devient interactif qu'au premier clic ou frappe dans la zone — avant cela, aucun gestionnaire d'événement Angular n'y est actif.
Activation dans la configuration de l'application :
import { provideClientHydration, withIncrementalHydration } from '@angular/platform-browser';
bootstrapApplication(App, {
providers: [provideClientHydration(withIncrementalHydration())],
});
Déclencheurs d'hydratation disponibles : hydrate on interaction, hydrate on hover, hydrate on viewport, hydrate on idle, hydrate on timer(500ms), hydrate when condition, et hydrate never (le bloc ne devient jamais interactif).
Les termes à connaître
- Hydratation incrémentale
Variante de l'hydratation (leçon précédente) qui n'hydrate pas toute la page d'un coup au démarrage, mais bloc par bloc, chacun selon son propre déclencheur (
@defer (hydrate on ...)). Un bloc non encore hydraté reste affiché tel quel (HTML statique) mais n'est pas interactif.- withIncrementalHydration()
Fonctionnalité à ajouter à
provideClientHydration()pour activer l'hydratation incrémentale dans l'application :provideClientHydration(withIncrementalHydration()). Active automatiquement le rejeu d'événements pour les blocs concernés.- @defer (hydrate on ...)
Syntaxe qui ajoute un déclencheur d'hydratation à un bloc
@defer, séparé par un point-virgule du déclencheur de chargement classique :@defer (on viewport; hydrate on interaction) { ... }. Le déclencheur d'hydratation s'applique au premier rendu (issu du SSR) ; le déclencheur classique reprend la main pour tout rendu client ultérieur.- hydrate on interaction / hover / viewport / idle / timer
Déclencheurs d'hydratation disponibles : au clic ou à la frappe (
interaction), au survol (hover), à l'entrée dans le viewport (viewport), quand le navigateur est inactif (idle), après un délai (timer(500ms)), ou selon une condition personnalisée (when).- hydrate never
Déclencheur qui maintient un bloc indéfiniment déshydraté : son HTML reste affiché tel quel, sans jamais devenir interactif côté client. Utile pour un contenu purement informatif qui n'a besoin d'aucune interactivité.
- TTI (Time to Interactive)
Indicateur de performance qui mesure le temps avant qu'une page devienne pleinement réactive aux interactions utilisateur. L'hydratation incrémentale vise à réduire ce délai en évitant d'hydrater immédiatement des blocs peu prioritaires.
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.