Formations — 1 037 leçons en français

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 .value dans 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'une ref sans é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 ref dont seul le remplacement de .value est suivi. L'intérieur n'est pas rendu profond, ce qui évite de proxyfier une grosse structure.

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.