À propos de ce cours
Chapitre 8 — Les formulaires Flutter · Créer un formulaire avec Form et GlobalKey
• 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.

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'),
),
),
],
),
],
),
),
);
}
}

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 renvoienullsi elle est correcte, ou le message à afficher sous le champ. validate()appelle tous les validateurs, affiche les messages et renvoietrueseulement si tous ont renvoyénull.save()appelle tous lesonSaved: on n'y écrit qu'après une validation réussie, d'où le!sans risque.currentStateestnulltant que le formulaire n'est pas affiché : le!indique à Dart que vous êtes sûr qu'il existe.- Le
SnackBars'affiche avecScaffoldMessenger.of(context)(l'ancienScaffold.of(context).showSnackBarn'existe plus).
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.•
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) :
- Où déclarez-vous la
GlobalKey<FormState>? Que se passe-t-il si vous la créez dans la méthodebuild? (essayez, puis tapez dans un champ) - É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) - Récupérez les valeurs avec
onSaveddans des variables, puis affichez un résumé dans unSnackBar. Que se passe-t-il si vous appelezsave()sansvalidate()? - Ajoutez un bouton « Effacer ». Le contenu des champs disparaît-il ? Et les messages d'erreur ?
- Donnez une valeur de départ au champ groupe avec
initialValue: 'DEV101'. Que faitreset()sur ce champ ? Peut-on utiliserinitialValueetcontrolleren même temps ? - 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é ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !