Formations — 1 037 leçons en français

Accueil › Vue.js › Les valeurs calculées

Les valeurs calculées

La réactivitédebutant

Un computed est une valeur dérivée d'autres valeurs réactives.

import { ref, computed } from 'vue'

const lignes = ref([{ prix: 10, qte: 2 }, { prix: 5, qte: 1 }])
const total = computed(() => lignes.value.reduce((s, l) => s + l.prix * l.qte, 0))

console.log(total.value)   // 25

Il renvoie une ref en lecture seule : .value dans le script, déballage automatique dans le template.

Deux propriétés le définissent, et ce sont elles que l'entretien vérifie :

C'est ce qui le distingue d'une méthode appelée dans le template : la méthode est réexécutée à chaque rendu, sans mémoire.

<template>
  <p>{{ total }}</p>        <!-- calculé une fois, relu autant qu'on veut -->
  <p>{{ calculerTotal() }}</p>  <!-- recalculé à chaque rendu -->
</template>

Un computed doit rester un calcul pur : pas de requête, pas d'écriture en stockage, aucune mutation de ses sources. Comme on ne sait ni quand ni combien de fois il s'exécutera, tout effet de bord qu'on y glisse devient imprévisible. Les effets appartiennent au watch.

Les termes à connaître

computed

Une ref en lecture seule dont la valeur est calculée à partir d'autres sources réactives. Mémorisée et paresseuse.

Mémorisation

Le résultat est conservé. Tant qu'aucune dépendance n'a changé, les lectures suivantes renvoient la valeur gardée sans réexécuter le calcul.

Paresse

Le calcul n'a lieu qu'à la lecture. Modifier une dépendance marque la valeur périmée sans rien recalculer tout de suite.

Dépendance

Toute source réactive lue pendant l'exécution du calcul. Les dépendances sont collectées à chaque exécution, et peuvent donc varier.

computed inscriptible

Un computed déclaré avec get et set. Écrire dedans redirige l'écriture vers les sources.

Effet de bord

Toute action observable hors du calcul : requête, mutation, écriture en stockage. Un computed n'en fait aucun.

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.