Accueil › Vue.js › Validation et composant contrôlé
Validation et composant contrôlé
Événements et formulairesdebutant
v-model produit un composant contrôlé : la valeur affichée vient de
l'état, et chaque saisie repasse par l'état. La validation découle de ce
principe — les erreurs se calculent à partir de l'état, elles ne se
stockent pas.
<script setup>
import { ref, computed } from 'vue'
const email = ref('')
const motDePasse = ref('')
const touches = ref({})
const soumis = ref(false)
const erreurs = computed(() => {
const e = {}
if (!email.value.trim()) e.email = 'L’adresse est requise.'
else if (!email.value.includes('@')) e.email = 'Adresse invalide.'
if (motDePasse.value.length < 8) e.motDePasse = 'Huit caractères minimum.'
return e
})
const valide = computed(() => Object.keys(erreurs.value).length === 0)
function visible(champ) {
return (touches.value[champ] || soumis.value) && erreurs.value[champ]
}
function envoyer() {
soumis.value = true
if (!valide.value) return
// envoi
}
</script>
<template>
<form @submit.prevent="envoyer" novalidate>
<input v-model.trim="email" @blur="touches.email = true" />
<p v-if="visible('email')">{{ erreurs.email }}</p>
<button>Envoyer</button>
</form>
</template>
Trois idées suffisent. Les erreurs sont un computed. Ce qui est stocké,
c'est seulement quand les montrer — touches et soumis. Et
@submit.prevent empêche le rechargement de page qui effacerait tout.
Les termes à connaître
- Composant contrôlé
Un champ dont la valeur affichée vient de l'état et dont chaque saisie passe par l'état.
v-modelen produit un par construction.- Validation dérivée
Calculer les erreurs à partir de l'état avec un
computed, plutôt que de les stocker dans un second état qu'il faudrait tenir à jour.- Champ touché
Un champ que l'utilisateur a quitté au moins une fois. Le marqueur qui permet de n'afficher une erreur qu'au bon moment.
- @submit.prevent
Le modificateur qui appelle
preventDefault()sur l'événement de soumission. Sans lui, le navigateur recharge la page.- Validation native
Les attributs HTML
required,minlength,pattern,type="email". Gratuits et accessibles, mais au message imposé par le navigateur.- Normalisation
Mettre la valeur en forme avant de l'envoyer — espaces, casse, format de date. Faite à la soumission, elle ne gêne pas la frappe.
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.