Formations — 1 037 leçons en français

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 watch qui 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 ref posé 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 watchEffect avec flush: 'post', qui garantit un DOM à jour pendant l'exécution du rappel.

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.