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

Créer un formulaire avec Form et GlobalKey

Créer un formulaire avec Form et GlobalKey. Dans cette leçon du cours Flutter, vous apprendrez à : regrouper des champs dans un widget Form identifié par une GlobalKeyFormState ; écrire une fonction v...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Créer un formulaire avec Form et GlobalKey. Dans cette leçon du cours Flutter, vous apprendrez à : regrouper des champs dans un widget Form identifié par une GlobalKeyFormState ; écrire une fonction validator et déclencher la validation avec validate() ; récupérer les valeurs avec onSaved et save(), et vider le formulaire avec reset() ; donner un retour à l'utilisateur après l'envoi.

Chapitre 8 — Les formulaires Flutter · Créer un formulaire avec Form et GlobalKey

🎯 Objectifs de la leçon
• regrouper des champs dans un widget Form identifié par une GlobalKey<FormState>;
• écrire une fonction validator et déclencher la validation avec validate();
• récupérer les valeurs avec onSaved et save(), et vider le formulaire avec reset();
• donner un retour à l'utilisateur après l'envoi.

1. Le widget Form et sa clé

Le widget Form est un conteneur invisible qui regroupe plusieurs champs pour les valider et les enregistrer ensemble. Pour lui parler depuis un bouton, on lui donne une clé globale: GlobalKey<FormState>. Grâce à elle, _formKey.currentState donne accès à l'état du formulaire et à ses trois méthodes.

Form, GlobalKey et FormState
Figure 1 — La clé relie le bouton au formulaire ; validate, save et reset agissent sur tous les champs.

2. Un formulaire de contact complet

import 'package:flutter/material.dart';

class ContactPage extends StatefulWidget {
  const ContactPage({super.key});

  @override
  State<ContactPage> createState() => _ContactPageState();
}

class _ContactPageState extends State<ContactPage> {
  final _formKey = GlobalKey<FormState>();
  String _nom = '';
  String _email = '';
  String _message = '';

  void _envoyer() {
    final form = _formKey.currentState!;
    if (!form.validate()) return;          // 1. affiche les erreurs, s'arrête si besoin
    form.save();                            // 2. appelle chaque onSaved
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('Merci $_nom, votre message a été envoyé.')),
    );
    form.reset();                           // 3. vide le formulaire
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Nous contacter')),
      body: Form(
        key: _formKey,
        child: ListView(
          padding: const EdgeInsets.all(16),
          children: [
            TextFormField(
              decoration: const InputDecoration(labelText: 'Nom', prefixIcon: Icon(Icons.person)),
              textInputAction: TextInputAction.next,
              validator: (valeur) {
                if (valeur == null || valeur.trim().isEmpty) return 'Le nom est obligatoire';
                return null;                                   // null = valeur correcte
              },
              onSaved: (valeur) => _nom = valeur!.trim(),
            ),
            const SizedBox(height: 16),
            TextFormField(
              decoration: const InputDecoration(labelText: 'E-mail', prefixIcon: Icon(Icons.email)),
              keyboardType: TextInputType.emailAddress,
              validator: (valeur) =>
                  (valeur == null || !valeur.contains('@')) ? 'E-mail invalide' : null,
              onSaved: (valeur) => _email = valeur!.trim(),
            ),
            const SizedBox(height: 16),
            TextFormField(
              decoration: const InputDecoration(labelText: 'Message', alignLabelWithHint: true),
              minLines: 4,
              maxLines: 8,
              maxLength: 500,
              validator: (valeur) => (valeur == null || valeur.trim().length < 10)
                  ? 'Au moins 10 caractères'
                  : null,
              onSaved: (valeur) => _message = valeur!.trim(),
            ),
            Row(
              children: [
                Expanded(
                  child: OutlinedButton(
                    onPressed: () => _formKey.currentState!.reset(),
                    child: const Text('Effacer'),
                  ),
                ),
                const SizedBox(width: 12),
                Expanded(
                  child: FilledButton.icon(
                    onPressed: _envoyer,
                    icon: const Icon(Icons.send),
                    label: const Text('Envoyer'),
                  ),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

Le formulaire de contact avant et après l'envoi
Aperçu reconstitué de l'écran (Material 3) : le code de la leçon produit cet affichage, aux couleurs du thème près.

  • Un validator reçoit la valeur (String?) et renvoie null si elle est correcte, ou le message à afficher sous le champ.
  • validate() appelle tous les validateurs, affiche les messages et renvoie true seulement si tous ont renvoyé null.
  • save() appelle tous les onSaved: on n'y écrit qu'après une validation réussie, d'où le ! sans risque.
  • currentState est null tant que le formulaire n'est pas affiché : le ! indique à Dart que vous êtes sûr qu'il existe.
  • Le SnackBar s'affiche avec ScaffoldMessenger.of(context) (l'ancien Scaffold.of(context).showSnackBar n'existe plus).
✅ Correction par rapport à l'ancienne version
Cette leçon a été mise à jour. L'ancienne version répétait plusieurs fois la même définition de la GlobalKey, écrivait GlobalKey () sans son type (GlobalKey<FormState> est indispensable pour accéder à validate()), _formKey.currentState.validate() sans le ! exigé par Dart 3, et présentait TextField comme le champ d'un formulaire. Les trois applications corrigées sont remplacées par une activité guidée ; la validation détaillée (modes automatiques, mots de passe, champs dépendants) fait l'objet de la leçon 8.3.
ℹ️ À retenir
• final _formKey = GlobalKey<FormState>(); puis Form(key: _formKey, child: …).
• validator: renvoie null si c'est correct, sinon le message d'erreur.
• _formKey.currentState!.validate() → save() → traitement → reset().
• Retour à l'utilisateur : ScaffoldMessenger.of(context).showSnackBar(…).

🛠 Activité 2 — Le formulaire de réservation de salle

Mission : Créez un formulaire de réservation d'une salle de cours : nom du formateur, groupe, nombre de stagiaires, motif.

Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :

  1. Où déclarez-vous la GlobalKey<FormState>? Que se passe-t-il si vous la créez dans la méthode build? (essayez, puis tapez dans un champ)
  2. Écrivez le validateur du nombre de stagiaires : obligatoire, entier, entre 1 et 30. Comment convertissez-vous le texte en nombre sans risque d'erreur ? (indice : int.tryParse)
  3. Récupérez les valeurs avec onSaved dans des variables, puis affichez un résumé dans un SnackBar. Que se passe-t-il si vous appelez save() sans validate()?
  4. Ajoutez un bouton « Effacer ». Le contenu des champs disparaît-il ? Et les messages d'erreur ?
  5. Donnez une valeur de départ au champ groupe avec initialValue: 'DEV101'. Que fait reset() sur ce champ ? Peut-on utiliser initialValue et controller en même temps ?
  6. Faites en sorte que la touche « Terminé » du clavier, sur le dernier champ, envoie le formulaire. Quelles propriétés utilisez-vous ?

Je vérifie / je rends :

  • ☐ Le code, et deux captures : formulaire avec erreurs, puis envoi réussi.

← Le widget TextFormField dans FlutterValider un formulaire avec Flutter →

Cet article vous a-t-il aidé ?