À propos de ce cours
Chapitre 8 — Les formulaires Flutter · Valider un formulaire avec Flutter
• choisir le moment où les erreurs s'affichent avec
AutovalidateMode; • regrouper les règles dans une classe de validateurs réutilisables ;
• valider un mot de passe règle par règle et une confirmation qui dépend d'un autre champ ;
• afficher sous un champ une erreur renvoyée par un serveur.
1. Quand valider ?

Figure 1 — onUserInteraction est le plus confortable : l'erreur apparaît dès que l'utilisateur a touché le champ.
Form(
key: _formKey,
autovalidateMode: AutovalidateMode.onUserInteraction, // pour tous les champs
child: …,
)
TextFormField(
autovalidateMode: AutovalidateMode.onUnfocus, // ou pour un seul champ
…
)
N'utilisez pas AutovalidateMode.always sur un formulaire vide : l'utilisateur serait accueilli par une page d'erreurs.
Un compromis fréquent : disabled au départ, puis passer à onUserInteraction après le premier clic sur « Valider »
(une variable d'état suffit).
2. Des validateurs réutilisables
/// Chaque méthode renvoie null si la valeur est correcte, sinon le message d'erreur.
class Validators {
Validators._(); // pas d'instance : on appelle Validators.email(…)
static final _email = RegExp(r'^[\w.+-]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*\.[a-zA-Z]{2,}$');
static String? obligatoire(String? v, {String champ = 'Ce champ'}) =>
(v == null || v.trim().isEmpty) ? '$champ est obligatoire' : null;
static String? email(String? v) {
final s = v?.trim() ?? '';
if (s.isEmpty) return "L'e-mail est obligatoire";
if (!_email.hasMatch(s)) return 'Format attendu : nom@domaine.com';
return null;
}
static String? motDePasse(String? v) {
final s = v ?? '';
if (s.isEmpty) return 'Le mot de passe est obligatoire';
if (s.length < 8) return 'Au moins 8 caractères';
if (!RegExp(r'[A-Z]').hasMatch(s)) return 'Au moins une lettre majuscule';
if (!RegExp(r'[a-z]').hasMatch(s)) return 'Au moins une lettre minuscule';
if (!RegExp(r'[0-9]').hasMatch(s)) return 'Au moins un chiffre';
if (!RegExp(r'[!@#$%^&*(),.?":{}|<>_-]').hasMatch(s)) return 'Au moins un caractère spécial';
return null;
}
static String? confirmation(String? v, String original) {
if (v == null || v.isEmpty) return 'Veuillez confirmer le mot de passe';
return v == original ? null : 'Les mots de passe ne correspondent pas';
}
static String? telephoneMaroc(String? v) {
final s = (v ?? '').replaceAll(' ', '');
return RegExp(r'^0[5-7]\d{8}$').hasMatch(s) ? null : 'Numéro à 10 chiffres (05, 06 ou 07)';
}
}
- Les règles sont écrites une seule fois et utilisées partout :
validator: Validators.email(sans parenthèses : on passe la fonction). - Pour passer un paramètre, on enveloppe :
validator: (v) => Validators.obligatoire(v, champ: 'Le nom'). - Des règles testées une par une donnent un message précis : « Au moins un chiffre » aide plus que « Mot de passe invalide ».
- Ces fonctions ne dépendent d'aucun widget : elles se testent avec
flutter test(voir le TP 8).
3. Des champs qui dépendent l'un de l'autre
final _mdpCtrl = TextEditingController();
final _confirmKey = GlobalKey<FormFieldState<String>>(); // clé d'UN champ
TextFormField(
controller: _mdpCtrl,
obscureText: true,
decoration: const InputDecoration(labelText: 'Mot de passe'),
validator: Validators.motDePasse,
onChanged: (_) => _confirmKey.currentState?.validate(), // revalide la confirmation
),
TextFormField(
key: _confirmKey,
obscureText: true,
decoration: const InputDecoration(labelText: 'Confirmation'),
validator: (v) => Validators.confirmation(v, _mdpCtrl.text),
),

Aperçu reconstitué de l'écran (Material 3) : le code de la leçon produit cet affichage, aux couleurs du thème près.
4. Une erreur venue du serveur
Un validateur est synchrone: il ne peut pas attendre la réponse d'un serveur (« cet e-mail est déjà utilisé »). On envoie d'abord, puis on mémorise l'erreur reçue dans une variable que le validateur renvoie, et on revalide :
String? _erreurServeur;
TextFormField(
decoration: const InputDecoration(labelText: 'E-mail'),
onChanged: (_) => _erreurServeur = null, // l'erreur disparaît si on corrige
validator: (v) => _erreurServeur ?? Validators.email(v),
),
Future<void> _inscrire() async {
if (!_formKey.currentState!.validate()) return;
final dejaPris = await api.emailExiste(_emailCtrl.text); // appel réseau (chapitre suivant)
if (dejaPris) {
_erreurServeur = 'Cet e-mail est déjà utilisé';
_formKey.currentState!.validate(); // affiche l'erreur sous le champ
}
}
Cette leçon a été mise à jour. Elle répétait une grande partie de la leçon précédente et donnait la solution complète de son application. Le validateur
if (value.isEmpty) ne compilait pas (valeur nullable), la règle « mot de passe entre 8 et 12 caractères » limitait inutilement la
longueur (les recommandations actuelles encouragent les mots de passe longs), et la validation « asynchrone » proposée ne pouvait pas fonctionner, un
validator ne pouvant pas attendre un Future. Le mode AutovalidateMode.onUnfocus, plus récent, a été ajouté.•
AutovalidateMode: disabled (au clic), onUserInteraction, onUnfocus, always. • Une classe
Validators de méthodes statiques : règles écrites une fois, messages précis, testables.• Champ dépendant :
GlobalKey<FormFieldState<String>> pour revalider un seul champ.• Erreur serveur : variable d'état renvoyée par le validateur, puis
validate(). 🛠 Activité 3 — L'inscription à la plateforme de cours
Mission : Créez l'écran d'inscription : nom complet, e-mail, téléphone, mot de passe, confirmation, avec des messages précis.
Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :
- Écrivez votre classe
Validatorsdans un fichierlib/utils/validators.dart. Pourquoi les méthodes sont-ellesstatic? - Testez les quatre modes de
AutovalidateModesur votre formulaire. Lequel choisissez-vous pour cet écran ? Justifiez du point de vue de l'utilisateur. - Pour le nom complet, exigez au moins deux mots. Quelle méthode des chaînes utilisez-vous ? Que faire des espaces multiples entre les mots ?
- Saisissez la confirmation, puis modifiez le mot de passe : l'erreur de la confirmation se met-elle à jour ? Corrigez avec une clé de champ.
- Simulez un serveur avec
Future.delayed(const Duration(seconds: 1), () => email == 'test@ista.ma'). Affichez « Cet e-mail est déjà utilisé » sous le champ. Pendant l'attente, comment empêchez-vous un double clic sur le bouton ? - Ajoutez sous le mot de passe une barre de force (faible / moyen / fort) qui évolue pendant la saisie. Dans quelle propriété du champ calculez-vous la force ?
Je vérifie / je rends :
- ☐ Le code, la classe Validators et trois captures (erreurs au clic, erreurs en direct, erreur serveur).
← Créer un formulaire avec Form et GlobalKeyValidation des e-mails dans Flutter →
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !