Formations — 1 037 leçons en français

Accueil › Vue.js › Les modificateurs de v-model

Les modificateurs de v-model

Événements et formulairesdebutant

Trois modificateurs intégrés transforment la liaison sans écrire une ligne de code.

<input v-model.lazy="recherche" />   <!-- écoute change, pas input -->
<input v-model.number="age" />       <!-- parseFloat sur la saisie -->
<input v-model.trim="pseudo" />      <!-- espaces de bord retirés -->

Ils se cumulent : v-model.lazy.trim.number="age".

.lazy ne temporise rien. Il remplace simplement l'événement écouté : change au lieu de input. L'état est donc mis à jour quand le champ perd le focus ou que l'utilisateur valide, et pas à chaque frappe.

.trim retire les espaces de début et de fin avant l'affectation. L'état ne contient jamais " ", mais le champ, lui, peut encore afficher des espaces pendant la frappe.

.number applique parseFloat. Le détail qui coûte des heures :

// ce que Vue fait, en substance
const n = parseFloat(valeur)
return isNaN(n) ? valeur : n

Si la conversion échoue, la chaîne d'origine est conservée. Un champ v-model.number peut donc contenir une chaîne, et typeof le prouve. Et comme parseFloat tronque, "12ans" donne 12 sans le moindre avertissement. .number est une commodité d'affectation, pas une validation.

Quand .trim et .number sont tous deux présents, .trim passe en premier.

Les termes à connaître

Modificateur

Un suffixe ajouté à une directive avec un point. Sur v-model, il change l'événement écouté ou transforme la valeur avant qu'elle n'atteigne l'état.

.lazy

Remplace l'écoute de input par celle de change : l'état n'est mis à jour qu'à la validation du champ, pas à chaque frappe.

.number

Applique parseFloat à la saisie. Si le résultat n'est pas un nombre, la chaîne d'origine est conservée telle quelle.

.trim

Retire les espaces de début et de fin avant l'affectation. Il s'applique avant .number.

Modificateur personnalisé

Sur un composant, tout suffixe de votre choix. L'enfant le reçoit dans l'objet de modificateurs et décide lui-même quoi en faire.

modelModifiers

La propriété où atterrissent les modificateurs du modèle par défaut. Pour un modèle nommé titre, c'est titreModifiers.

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.