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

Le widget TextFormField dans Flutter

Le widget TextFormField dans Flutter. Dans cette leçon du cours Flutter, vous apprendrez à : ajouter un champ de saisie TextFormField et le décorer avec InputDecoration ; adapter le clavier et la sais...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Le widget TextFormField dans Flutter. Dans cette leçon du cours Flutter, vous apprendrez à : 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().

Chapitre 8 — Les formulaires Flutter · Le widget TextFormField dans Flutter

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

Les parties d'un 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'),
)

Plusieurs TextFormField décorés
Aperçu reconstitué de l'écran (Material 3) : le code de la leçon produit cet affichage, aux couleurs du thème près.

  • keyboardType choisit le clavier : TextInputType.number, .phone, .emailAddress, .multiline… Le clavier n'empêche pas de coller du texte : il faut toujours valider.
  • inputFormatters filtre la saisie caractère par caractère, par exemple [FilteringTextInputFormatter.digitsOnly, LengthLimitingTextInputFormatter(10)] pour un téléphone (import package:flutter/services.dart).
  • textInputAction et onFieldSubmitted permettent 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 TextEditingController permet de lire (.text), modifier (.text = '…') ou vider (.clear()) le champ à tout moment, depuis n'importe quelle méthode de l'écran.
  • onChanged est 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 dans build) et appelez dispose() dans la méthode dispose de l'écran.
✅ Correction par rapport à l'ancienne version
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.
ℹ️ À retenir
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.
ℹ️ À retenir
• 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) :

  1. Pour chaque champ, choisissez le keyboardType adapté. Lequel choisissez-vous pour le téléphone ? Que se passe-t-il si l'utilisateur colle « 06 12 ab » malgré tout ?
  2. Limitez le téléphone à 10 chiffres avec inputFormatters. Quel import faut-il ajouter ?
  3. 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?
  4. Affichez sous le formulaire une carte « Nom — e-mail » qui se met à jour à chaque caractère. Utilisez-vous un contrôleur ou onChanged? Justifiez.
  5. Ajoutez un bouton « Effacer » qui vide tous les champs. Quelle méthode du contrôleur utilisez-vous ? Pourquoi est-ce impossible avec onChanged seul ?
  6. Retirez les appels à dispose(). L'application fonctionne-t-elle encore ? Expliquez pourquoi il faut quand même les écrire.
  7. 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é ?