Accueil › Vue.js › v-model en première approche
v-model en première approche
Template et directivesdebutant
v-model lie un champ de formulaire à un état, dans les deux sens : l'état
remplit le champ, et la saisie met l'état à jour.
<script setup>
import { ref } from 'vue'
const message = ref('')
const accepte = ref(false)
const pays = ref('fr')
</script>
<template>
<input v-model="message">
<p>Vous avez écrit : {{ message }}</p>
<input type="checkbox" v-model="accepte">
<select v-model="pays">
<option value="fr">France</option>
<option value="be">Belgique</option>
</select>
</template>
Ce n'est pas un mécanisme à part : c'est du sucre syntaxique. Sur un champ
texte, v-model="message" équivaut à :
<input :value="message" @input="message = $event.target.value">
Vue adapte la paire à l'élément : checked et change pour une case à
cocher, la valeur et change pour une liste déroulante. C'est pour cela que
v-model fonctionne de la même manière sur tous les champs alors que le DOM,
lui, ne les traite pas pareil.
Trois modificateurs accompagnent la directive : .lazy pour attendre
l'événement change, .number pour convertir en nombre, .trim pour couper
les espaces de bord.
Enfin, v-model et :value sur le même champ se contredisent : il faut
choisir l'un ou l'autre.
Les termes à connaître
- v-model
La directive de liaison bidirectionnelle : elle lie la valeur d'un champ à un état et met cet état à jour à chaque saisie.
- Sucre syntaxique
v-modelne fait rien qu'on ne puisse écrire à la main : c'est une liaison de valeur plus un écouteur, en une seule écriture.- .lazy
Synchronise sur l'événement
changeau lieu deinput: la mise à jour attend la perte du focus ou la validation.- .number
Convertit la saisie en nombre. Appliqué d'office sur un champ de type « number ».
- .trim
Retire les espaces en début et en fin de saisie avant d'écrire dans l'état.
- true-value / false-value
Sur une case à cocher, elles remplacent
trueetfalsepar les valeurs de votre choix.
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.