Formations — 1 037 leçons en français

Accueil › Vue.js › v-bind et sa forme courte

v-bind et sa forme courte

Template et directivesdebutant

Les moustaches ne fonctionnent pas dans un attribut. C'est v-bind qui lie un attribut à une expression.

<script setup>
const url = '/produits/42'
const desactive = true
</script>

<template>
  <a v-bind:href="url">Voir le produit</a>
  <a :href="url">Voir le produit</a>          <!-- forme courte, identique -->
  <button :disabled="desactive">Acheter</button>
</template>

Ce qui suit les deux-points est l'argument de la directive : l'attribut visé. La valeur entre guillemets est une expression JavaScript, pas une chaîne littérale. :href="url" lie la variable url ; href="url" poserait le texte url.

La forme courte :href est celle qu'on rencontre partout dans le code réel. Depuis Vue 3.4, quand l'attribut et la variable portent le même nom, on peut même écrire :url pour :url="url".

Trois règles de rendu à connaître par cœur :

Ces trois règles expliquent la quasi-totalité des « pourquoi mon attribut n'apparaît pas » des premiers jours.

Les termes à connaître

v-bind

La directive qui lie un attribut, une propriété DOM ou une prop de composant à une expression. Forme courte : les deux-points.

Argument de directive

Ce qui suit les deux-points dans v-bind:href. Ici href : l'attribut visé. Il peut être dynamique avec des crochets.

Attribut supprimé

Une liaison qui vaut null ou undefined ne rend pas l'attribut du tout. false rend la chaîne « false » sur un attribut ordinaire.

Syntaxe objet de class

:class="{ actif: estActif }" ajoute la classe quand la valeur est vraie. Le résultat fusionne avec l'attribut class statique.

Syntaxe objet de style

:style="{ fontSize: taille + 'px' }" ; les propriétés CSS s'écrivent en camelCase ou en kebab-case entre guillemets.

Liaison sans argument

v-bind="objet" répand toutes les paires clé/valeur d'un objet comme autant d'attributs.

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.