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
inputpar celle dechange: 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'esttitreModifiers.
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.