Comment `v-model` implémente-t-il la liaison bidirectionnelle ?

v-model crée une liaison bidirectionnelle entre une entrée de formulaire et un élément d'état : l'entrée affiche la valeur de l'état, et la modification de l'entrée met à jour l'état — automatiquement, dans les deux directions.

vue

<script setup>
import { ref } from "vue";
const name = ref("");
</script>

<template>
  <input v-model="name" />
  <p>You typed: {{ name }}</p>   <!-- updates live as you type -->
</template>

C'est du sucre syntaxique

Sous le capot, combine une liaison et un écouteur :

v-model

:value

@input

vue

<template>
  <input v-model="text" />                 <!-- text -->
  <textarea v-model="message" />
  <input type="checkbox" v-model="agreed" /> <!-- boolean -->
  <input type="radio" value="a" v-model="choice" />
  <select v-model="selected">...</select>
</template>

vue

<input v-model.trim="name" />    <!-- auto-trim whitespace -->
<input v-model.number="age" />   <!-- cast to a number -->
<input v-model.lazy="text" />    <!-- sync on `change` instead of every keystroke -->

vue

<!-- a component can support v-model via a `modelValue` prop + `update:modelValue` event -->
<CustomInput v-model="name" />
<!-- equivalent to :model-value="name" @update:model-value="name = $event" -->

Comment `v-model` implémente-t-il la liaison bidirectionnelle ?

C'est du sucre syntaxique

Fonctionne sur tous les contrôles de formulaire

Modificateurs

v-model sur les composants personnalisés

Pourquoi c'est important