Accueil › Vue.js › Les crochets qui comptent
Les crochets qui comptent
Cycle de vie et effetsintermediaire
Un composant naît, s'affiche, se met à jour, puis disparaît. Vue expose ces
moments sous forme de fonctions à enregistrer dans setup.
<script setup>
import { ref, onMounted, onUnmounted } from 'vue'
const largeur = ref(0)
const boite = ref(null)
onMounted(() => {
largeur.value = boite.value.offsetWidth // le DOM existe enfin
})
onUnmounted(() => {
// on défait ici ce qu'on a mis en place plus haut
})
</script>
<template>
<div ref="boite">{{ largeur }} px</div>
</template>
Trois crochets couvrent la quasi-totalité des besoins réels :
onMounted— le DOM du composant existe. On y branche ce qui a besoin d'un nœud réel ou d'une API du navigateur.onUnmounted— le composant a été retiré. On y arrête ce qui survivrait sans lui.onUpdated— le DOM vient d'être mis à jour. Rarement nécessaire, et dangereux si l'on y modifie l'état.
onBeforeMount n'apporte presque rien : le corps de <script setup>
s'exécute déjà avant le premier rendu, sans accès au DOM lui non plus.
L'ordre entre parent et enfant est la question posée en entretien. Les crochets
« before » descendent du parent vers l'enfant. Les crochets d'achèvement
remontent : onMounted de l'enfant s'exécute avant celui du parent, parce
qu'un parent n'est pas monté tant que ses enfants ne le sont pas.
Enregistrez toujours ces appels de façon synchrone dans setup. Vue associe le
crochet au composant actif au moment de l'appel ; dans un setTimeout ou un
gestionnaire d'événement, il n'y a plus de composant actif.
Les termes à connaître
- Crochet de cycle de vie
Une fonction que Vue appelle à un moment précis de la vie d'un composant. En Composition API, on l'enregistre avec
onMounted,onUnmountedet leurs voisines.- onMounted
Appelé une fois, après que le composant a inséré ses nœuds dans le document. C'est le premier instant où le DOM du composant est accessible.
- onUnmounted
Appelé une fois, après que le composant et ses enfants ont été retirés. C'est l'endroit où l'on défait ce qu'on a mis en place.
- onUpdated
Appelé après chaque mise à jour du DOM provoquée par un changement d'état du composant. Il ne dit pas ce qui a changé.
- onBeforeMount
Appelé juste avant le premier rendu, quand le DOM du composant n'existe pas encore. Le corps de
setups'exécute déjà plus tôt, ce qui le rend rarement utile.- Ordre parent/enfant
Les crochets « before » descendent du parent vers l'enfant ; les crochets d'achèvement remontent de l'enfant vers le parent.
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.