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
visitesdistinct 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-describedbypointant vers le message, il rend l'erreur audible.
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.