À propos de ce cours
Chapitre 8 — Les formulaires Flutter · Le widget TextFormField dans Flutter
• ajouter un champ de saisie
TextFormField et le décorer avec InputDecoration; • adapter le clavier et la saisie (
keyboardType, obscureText, maxLength, inputFormatters) ;• lire la valeur saisie avec un
TextEditingController ou onChanged; • libérer correctement un contrôleur avec
dispose(). 1. TextField ou TextFormField ?
Flutter propose deux champs de saisie de texte. TextField est le champ de base. TextFormField est le même champ,
enveloppé dans un FormField: il sait se valider (propriété validator) et s'enregistrer
(onSaved) quand il est placé dans un widget Form (leçon 8.2). Dans un formulaire, utilisez toujours TextFormField.

Figure 1 — Chaque partie visible du champ correspond à une propriété de InputDecoration.
2. Décorer et configurer le champ
TextFormField(
decoration: const InputDecoration(
labelText: 'E-mail', // libellé qui « flotte » au-dessus
hintText: 'nom@domaine.ma', // exemple affiché quand le champ est vide
helperText: 'Nous ne partagerons jamais votre adresse',
prefixIcon: Icon(Icons.email_outlined),
border: OutlineInputBorder(), // champ encadré
),
keyboardType: TextInputType.emailAddress, // clavier avec @
textInputAction: TextInputAction.next, // touche « suivant » du clavier
autocorrect: false,
)
TextFormField(
obscureText: true, // masque les caractères
decoration: InputDecoration(
labelText: 'Mot de passe',
prefixIcon: const Icon(Icons.lock_outline),
suffixIcon: IconButton(
icon: Icon(_masque ? Icons.visibility : Icons.visibility_off),
onPressed: () => setState(() => _masque = !_masque),
),
),
)
TextFormField(
maxLength: 300, // affiche le compteur 0/300
minLines: 3,
maxLines: 6, // champ multiligne
decoration: const InputDecoration(labelText: 'Présentation'),
)

Aperçu reconstitué de l'écran (Material 3) : le code de la leçon produit cet affichage, aux couleurs du thème près.
keyboardTypechoisit le clavier :TextInputType.number,.phone,.emailAddress,.multiline… Le clavier n'empêche pas de coller du texte : il faut toujours valider.inputFormattersfiltre la saisie caractère par caractère, par exemple[FilteringTextInputFormatter.digitsOnly, LengthLimitingTextInputFormatter(10)]pour un téléphone (importpackage:flutter/services.dart).textInputActionetonFieldSubmittedpermettent de passer au champ suivant ou d'envoyer le formulaire depuis le clavier.- Pour harmoniser tous les champs de l'application, définissez la décoration une seule fois dans le thème :
ThemeData(inputDecorationTheme: …).
3. Lire la valeur saisie
class _ProfilState extends State<Profil> {
final _nomCtrl = TextEditingController(); // 1. créer le contrôleur
String _apercu = '';
@override
void dispose() {
_nomCtrl.dispose(); // 4. le libérer quand l'écran disparaît
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
TextFormField(
controller: _nomCtrl, // 2. l'associer au champ
decoration: const InputDecoration(labelText: 'Nom'),
onChanged: (valeur) => setState(() => _apercu = valeur.toUpperCase()),
),
Text('Aperçu : $_apercu'),
FilledButton(
onPressed: () => debugPrint('Nom saisi : ${_nomCtrl.text}'), // 3. lire .text
child: const Text('Afficher'),
),
],
);
}
}
- Un
TextEditingControllerpermet de lire (.text), modifier (.text = '…') ou vider (.clear()) le champ à tout moment, depuis n'importe quelle méthode de l'écran. onChangedest appelé à chaque caractère: pratique pour un aperçu ou une recherche en direct. N'y lancez pas de traitement lourd.- Un contrôleur occupe de la mémoire : créez-le dans un
State(jamais dansbuild) et appelezdispose()dans la méthodedisposede l'écran.
Cette leçon a été mise à jour. L'ancienne version contenait des exemples qui ne compilent pas avec Dart 3 :
value.isEmpty alors que value est de type String? (il faut value == null || value.isEmpty),
onSaved: (value) => _email = value avec une variable String (il faut value ?? '' ou une variable String?), et
la chaîne 'S'il vous plaît…', coupée par l'apostrophe (utilisez des guillemets doubles : "S'il vous plaît…"). « onChange() » s'écrit
onChanged et ce n'est pas une méthode mais une propriété qui reçoit une fonction ; Colors.blue.withOpacity() est remplacé par
withValues(alpha: …) dans les versions récentes de Flutter.Depuis Flutter 3.47, la bibliothèque Material existe aussi sous forme de paquet séparé :
flutter pub add material_ui, puis
import 'package:material_ui/material_ui.dart';. Les widgets portent exactement les mêmes noms. L'import historique
package:flutter/material.dart, utilisé dans ce cours, fonctionne toujours ; il est marqué « obsolète » à partir de Flutter 3.50 et la commande
dart fix --apply --code=migrate_design_widgets fait la migration automatiquement.• Dans un formulaire :
TextFormField (validation et enregistrement), décoré par InputDecoration. •
keyboardType, obscureText, maxLength, inputFormatters adaptent la saisie ; ils ne remplacent pas la validation.•
TextEditingController: lire, modifier, vider le champ ; toujours dispose(). •
onChanged: réagir à chaque caractère.🛠 Activité 1 — L'écran « Mon profil »
Mission : Créez un écran « Mon profil » avec un champ par information (nom, e-mail, téléphone, mot de passe, présentation) et un aperçu en direct de la carte de visite.
Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :
- Pour chaque champ, choisissez le
keyboardTypeadapté. Lequel choisissez-vous pour le téléphone ? Que se passe-t-il si l'utilisateur colle « 06 12 ab » malgré tout ? - Limitez le téléphone à 10 chiffres avec
inputFormatters. Quel import faut-il ajouter ? - Ajoutez une icône « œil » au mot de passe. Quelle variable d'état vous faut-il, et pourquoi l'écran doit-il être un
StatefulWidget? - Affichez sous le formulaire une carte « Nom — e-mail » qui se met à jour à chaque caractère. Utilisez-vous un contrôleur ou
onChanged? Justifiez. - Ajoutez un bouton « Effacer » qui vide tous les champs. Quelle méthode du contrôleur utilisez-vous ? Pourquoi est-ce impossible avec
onChangedseul ? - Retirez les appels à
dispose(). L'application fonctionne-t-elle encore ? Expliquez pourquoi il faut quand même les écrire. - Déplacez la décoration commune (bordure, couleur de fond, rayon) dans
inputDecorationTheme. Combien de lignes avez-vous supprimées ?
Je vérifie / je rends :
- ☐ Le code de l'écran et une capture sur votre émulateur.
Créer un formulaire avec Form et GlobalKey →
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 !