Formations — 1 037 leçons en français

Accueil › React › Valider une saisie

Valider une saisie

Les formulairesdebutant

La validation est une fonction pure : des valeurs en entrée, un objet d'erreurs en sortie. Pas d'état, pas d'effet.

export function valider(v) {
  const erreurs = {};

  if (!v.nom.trim()) erreurs.nom = "Le nom est obligatoire";
  else if (v.nom.trim().length < 2) erreurs.nom = "Au moins deux caractères";

  if (!v.email.trim()) erreurs.email = "L'email est obligatoire";
  else if (!v.email.includes("@")) erreurs.email = "Format d'email invalide";

  if (!v.cgv) erreurs.cgv = "Vous devez accepter les conditions";

  return erreurs;
}

Une erreur par champ, et le champ obligatoire testé avant le format : un else if, pas deux if. Sinon un champ vide est déclaré « invalide » alors que l'utilisateur n'a rien tapé.

Cette fonction vit dans son propre fichier et se teste par une table de cas, sans monter un seul composant.

Le moment où l'on affiche

const [valeurs, setValeurs] = useState(VIDE);
const [visites, setVisites] = useState({});
const erreurs = valider(valeurs);              // recalculé à chaque rendu

const montrer = (champ) => visites[champ] && erreurs[champ];

<input
  name="email"
  value={valeurs.email}
  onChange={changer}
  onBlur={() => setVisites((p) => ({ ...p, email: true }))}
  aria-invalid={Boolean(montrer("email"))}
/>
{montrer("email") && <p className="erreur">{erreurs.email}</p>}

L'erreur apparaît quand l'utilisateur quitte le champ, puis se met à jour à chaque frappe : il la voit disparaître pendant qu'il corrige.

Les erreurs ne sont pas stockées dans un état. Elles sont dérivées des valeurs, donc toujours à jour.

Les termes à connaître

Fonction de validation pure

Une fonction qui reçoit les valeurs et rend un objet d'erreurs, sans lire d'état ni modifier quoi que ce soit. Elle se teste sans React.

Objet d'erreurs

Un objet dont les clés sont les noms de champs et les valeurs des messages. Vide quand tout est valide — Object.keys(erreurs).length === 0.

Champ visité

Un champ que l'utilisateur a quitté au moins une fois. On ne montre son erreur qu'à partir de là, d'où un état visites distinct des valeurs.

Validation native

Les contraintes HTML (required, type="email", min, pattern) vérifiées par le navigateur. Gratuites, accessibles, mais aux messages non personnalisables.

`noValidate`

Un attribut du <form> qui désactive l'affichage des bulles natives. On le pose quand on veut gérer entièrement les messages, tout en gardant les attributs de contrainte pour le sens.

`aria-invalid`

Un attribut qui signale un champ en erreur aux technologies d'assistance. Associé à aria-describedby pointant vers le message, il rend l'erreur audible.

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.