Formations — 1 037 leçons en français

Accueil › Vue.js › L'hydratation et ses écarts

L'hydratation et ses écarts

Nuxt et le rendu serveuravance

L'hydratation est l'opération par laquelle Vue reprend un HTML existant au lieu de le créer. Le navigateur a déjà peint la page ; Vue parcourt son arbre de nœuds virtuels en parallèle du DOM réel, fait correspondre les deux, et attache les écouteurs et la réactivité aux éléments trouvés.

Cela suppose que les deux arbres coïncident. S'ils divergent, Vue est en écart d'hydratation.

<script setup>
// Rendu sur le serveur à 14h02. Rendu sur le client à 14h02 et 300 ms,
// peut-être dans un autre fuseau.
const heure = new Date().toLocaleTimeString('fr-FR')
</script>

<template><span>{{ heure }}</span></template>

Ce que Vue fait alors est important : il jette le HTML du serveur pour le sous-arbre concerné, le rend à nouveau côté client, et signale l'écart en développement. L'application ne casse pas. C'est précisément pour cela que les écarts survivent : rien ne s'arrête, seul le journal proteste.

Le coût est double. Un scintillement visible, parce que le contenu change sous les yeux de l'utilisateur. Et un travail de rendu refait pendant la phase où le navigateur est le plus chargé.

La règle qui évite presque tous les cas : tout ce qui dépend de l'instant, du hasard, du fuseau, ou de l'état du navigateur ne doit pas être rendu dans le premier rendu.

Les termes à connaître

Hydratation

L'étape où Vue, dans le navigateur, parcourt le HTML reçu du serveur et y rattache ses nœuds virtuels, ses écouteurs et sa réactivité, au lieu de recréer le DOM.

Écart d'hydratation

Une divergence entre le HTML produit par le serveur et celui que le client calcule au premier rendu. Vue l'annonce en développement et répare la zone concernée.

data-allow-mismatch

Attribut introduit par Vue 3.5. Posé sur un élément, il fait taire l'avertissement d'écart pour cet élément. Il accepte une valeur — text, children, class, style, attribute — pour n'en tolérer qu'un type.

ClientOnly

Composant fourni par Nuxt. Son contenu n'est pas rendu sur le serveur ; il apparaît après l'hydratation. Un slot #fallback permet d'afficher autre chose en attendant.

Hydratation paresseuse

Possibilité offerte par Vue 3.5 pour les composants asynchrones : retarder leur hydratation jusqu'à ce qu'ils soient visibles, que le navigateur soit libre, ou qu'on interagisse avec eux.

Interactivité différée

La fenêtre pendant laquelle la page est affichée mais pas encore hydratée. Le contenu est là, les clics ne font rien.

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.