Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Flutter

Valider un formulaire avec Flutter

Valider un formulaire avec Flutter. Dans cette leçon du cours Flutter, vous apprendrez à : choisir le moment où les erreurs s'affichent avec AutovalidateMode ; regrouper les règles dans une classe de ...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Valider un formulaire avec Flutter. Dans cette leçon du cours Flutter, vous apprendrez à : 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.

Chapitre 8 — Les formulaires Flutter · Valider un formulaire avec Flutter

🎯 Objectifs de la leçon
• 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 ?

Les modes de AutovalidateMode
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),
),

Erreurs affichées au clic, puis pendant la saisie
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
  }
}
✅ Correction par rapport à l'ancienne version
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é.
ℹ️ À retenir
• 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) :

  1. Écrivez votre classe Validators dans un fichier lib/utils/validators.dart. Pourquoi les méthodes sont-elles static?
  2. Testez les quatre modes de AutovalidateMode sur votre formulaire. Lequel choisissez-vous pour cet écran ? Justifiez du point de vue de l'utilisateur.
  3. 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 ?
  4. Saisissez la confirmation, puis modifiez le mot de passe : l'erreur de la confirmation se met-elle à jour ? Corrigez avec une clé de champ.
  5. 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 ?
  6. 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é ?