Accueil › Vue.js › nextTick et le DOM différé
nextTick et le DOM différé
Cycle de vie et effetsintermediaire
Écrire dans une ref ne met pas le DOM à jour sur-le-champ. Vue note que le
composant doit être re-rendu, puis vide sa file dans une micro-tâche, une fois
le code synchrone en cours terminé.
<script setup>
import { ref, nextTick, useTemplateRef } from 'vue'
const message = ref('bonjour')
const paragraphe = useTemplateRef('paragraphe')
async function changer() {
message.value = 'au revoir'
console.log(paragraphe.value.textContent) // « bonjour » : pas encore rendu
await nextTick()
console.log(paragraphe.value.textContent) // « au revoir »
}
</script>
<template>
<p ref="paragraphe">{{ message }}</p>
</template>
Ce décalage est une optimisation, pas un défaut. Trois écritures successives ne produisent qu'un seul rendu, et les états intermédiaires ne sont jamais affichés.
nextTick() renvoie une promesse résolue après l'application de la mise à jour
en attente. On l'attend chaque fois qu'on a besoin du DOM mis à jour : mesurer
un élément, placer le curseur dans un champ qui vient d'apparaître, faire
défiler jusqu'à une ligne ajoutée.
Même règle du côté des observateurs : un watch s'exécute avant le rendu
par défaut. Pour lire le DOM depuis un watch, il faut flush: 'post'.
Les termes à connaître
- nextTick
Fonction de Vue qui renvoie une promesse résolue une fois la mise à jour du DOM en attente appliquée.
- Mise à jour groupée
Le fait que Vue accumule les changements d'état d'un même tour de boucle et n'effectue qu'un seul rendu.
- File de rendu
La file interne dans laquelle Vue place les composants à re-rendre. Elle est vidée dans une micro-tâche.
- flush
L'option d'un
watchqui décide s'il s'exécute avant la mise à jour du DOM, après, ou immédiatement.- Référence de template
L'attribut
refposé sur un élément, qui expose le nœud réel. Sa valeur n'est à jour qu'après le rendu correspondant.- watchPostEffect
Raccourci de
watchEffectavecflush: 'post', qui garantit un DOM à jour pendant l'exécution du rappel.
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.