Formations — 1 037 leçons en français

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-model en 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.

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.