Formations — 1 037 leçons en français

Accueil › Vue.js › Interpolation et expressions

Interpolation et expressions

Template et directivesdebutant

Le template d'un composant Vue est du HTML valide, enrichi de deux choses : des interpolations {{ }} dans le texte, et des directives dans les attributs.

<script setup>
const produit = { nom: 'Clavier', prix: 49.9 }
const quantite = 2
</script>

<template>
  <h2>{{ produit.nom }}</h2>
  <p>Total : {{ (produit.prix * quantite).toFixed(2) }} €</p>
</template>

Entre les moustaches, Vue évalue une expression JavaScript, pas un bloc. Une expression produit une valeur : a + b, liste.length, un appel de méthode, un opérateur ternaire. Une instruction n'en produit pas : const x = 1, if (…) { … }, return. La seconde famille est refusée.

Cette expression est évaluée dans la portée du template. Avec <script setup>, toute déclaration de premier niveau — constante, fonction, ref — y est visible sans aucun export. Le template voit en plus une courte liste de globales autorisées (Math, Date, JSON…), mais ni window, ni localStorage.

Le résultat est inséré comme texte. Si la valeur contient des balises, l'utilisateur lit les balises. C'est le comportement voulu : il rend impossible l'injection de HTML par une donnée.

Dernier point, celui qui fait trébucher tout le monde : les moustaches ne fonctionnent que dans le texte. Pour remplir un attribut, il faut la directive v-bind, sujet de la leçon suivante.

Les termes à connaître

Interpolation (moustaches)

La syntaxe {{ expression }} qui insère une valeur dans le texte d'un élément. Vue échappe le HTML : la valeur est toujours rendue comme du texte.

Expression de template

Une seule expression JavaScript, pas une instruction. a + b est accepté, const x = 1 ne l'est pas.

Portée du template

La liste des choses visibles depuis le template. Avec <script setup>, toutes les déclarations de premier niveau le sont automatiquement.

v-text

La directive équivalente aux moustaches. Elle remplace tout le contenu de l'élément, ce que {{ }} ne fait pas.

v-html

Insère une chaîne comme du HTML réel, sans échappement. À réserver à du contenu dont vous maîtrisez l'origine.

v-once

Rend l'élément une seule fois et ignore ensuite les mises à jour. Un outil d'optimisation, pas un réglage par défaut.

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.