Formations — 1 037 leçons en français

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 :

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, onUnmounted et 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 setup s'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.

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.