Accueil › Vue.js › ref et reactive
ref et reactive
La réactivitédebutant
Vue 3 propose deux façons de déclarer un état réactif.
import { ref, reactive } from 'vue'
const compteur = ref(0) // n'importe quelle valeur
const etat = reactive({ nom: 'Ada' }) // un objet, uniquement
ref enveloppe une valeur dans un conteneur. On y accède par .value dans
le script, jamais dans le template :
<script setup>
import { ref } from 'vue'
const compteur = ref(0)
function incrementer() { compteur.value++ }
</script>
<template>
<button @click="incrementer">{{ compteur }}</button>
</template>
reactive pose un proxy sur un objet existant. Pas de .value, mais deux
limites sérieuses : il refuse les primitives, et il perd le lien dès qu'on
réaffecte la variable.
let etat = reactive({ n: 0 })
etat = { n: 1 } // la vue ne bouge plus : ce nouvel objet n'est pas suivi
La règle de choix tient en une ligne : utilisez ref par défaut. C'est la
recommandation de la documentation officielle, et elle évite d'avoir à se
demander, à chaque déclaration, si la valeur restera un objet. reactive
garde un usage ponctuel : un groupe de champs manipulés ensemble, muté sur
place et jamais remplacé.
Le prix de ref, c'est .value. Le template le déballe pour vous, et un
objet reactive aussi — ailleurs, l'oublier est l'erreur de débutant la plus
fréquente de Vue 3.
Les termes à connaître
- ref
Un conteneur réactif qui accepte n'importe quelle valeur, primitive comprise. On lit et on écrit sa valeur par
.valuedans le script.- reactive
Un proxy posé sur un objet existant. Il rend réactives les propriétés de cet objet, et refuse les primitives.
- Proxy
L'objet intermédiaire de JavaScript qui intercepte lectures et écritures. C'est lui qui permet à Vue de savoir qui lit quoi, sans compilation.
- Déballage automatique
Le fait que le template, et un objet
reactive, exposent la valeur d'unerefsans écrire.value.- Collecte de dépendances
Vue note, pendant l'exécution d'un effet, quelles propriétés réactives ont été lues. Il ne réexécutera cet effet que si l'une d'elles change.
- shallowRef
Une
refdont seul le remplacement de.valueest suivi. L'intérieur n'est pas rendu profond, ce qui évite de proxyfier une grosse structure.
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.