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 :
- une valeur
nullouundefinedsupprime l'attribut ; falsesur un attribut booléen du HTML (disabled,checked) le supprime aussi, mais sur un attribut ordinaire il est rendu comme la chaîne « false » ;- pour
classetstyle, la valeur liée est fusionnée avec la valeur statique au lieu de la remplacer.
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. Icihref: l'attribut visé. Il peut être dynamique avec des crochets.- Attribut supprimé
Une liaison qui vaut
nullouundefinedne rend pas l'attribut du tout.falserend 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'attributclassstatique.- 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.
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.