Formations — 1 037 leçons en français

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-model ne 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 change au lieu de input : 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 true et false par les valeurs de votre choix.

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.