Formulaires et validation Flutter

Cette section présentera la création, la validation et la gestion de la soumission des formulaires dans Flutter.


TextFormField - Saisie de formulaire

TextFormField est un TextField spécialement conçu pour les formulaires, avec prise en charge intégrée de la validation.

Exemple : Formulaire de base

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

  @override
  State<LoginForm> createState() => _LoginFormState();
}

class _LoginFormState extends State<LoginForm> {
  // Clé de formulaire (pour la validation)
  final _formKey = GlobalKey<FormState>();

  // Contrôleurs de saisie
  final _usernameController = TextEditingController();
  final _passwordController = TextEditingController();

  @override
  void dispose() {
    _usernameController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: [
          // Saisie du nom d'utilisateur
          TextFormField(
            controller: _usernameController,
            decoration: const InputDecoration(
              labelText: Nom d'utilisateur,
              prefixIcon: Icon(Icons.person),
            ),
            // Validateur
            validator: (value) {
              if (value == null || value.isEmpty) {
                return 'Veuillez saisir un nom d’utilisateur';
              }
              if (value.length < 3) {
                return 'Le nom d’utilisateur doit contenir au moins 3 caractères';
              }
              return null;
            },
          ),
          const SizedBox(height: 16),
          // Saisie du mot de passe
          TextFormField(
            controller: _passwordController,
            obscureText: true,  // Masquer le mot de passe
            decoration: const InputDecoration(
              labelText: Mot de passe,
              prefixIcon: Icon(Icons.lock),
            ),
            validator: (value) {
              if (value == null || value.isEmpty) {
                return 'Veuillez saisir le mot de passe';
              }
              if (value.length < 6) {
                return 'Le mot de passe doit contenir au moins 6 caractères';
              }
              return null;
            },
          ),
          const SizedBox(height: 24),
          // Bouton de soumission
          ElevatedButton(
            onPressed: _submit,
            child: const Text('Connexion'),
          ),
        ],
      ),
    );
  }

  void _submit() {
    // Valider le formulaire
    if (_formKey.currentState?.validate() ?? false) {
      // Validation réussie
      print('Identifiant : ${_usernameController.text}');
      print('Mot de passe : ${_passwordController.text}');
      // Envoyer au serveur...
    } else {
      // Échec de la validation
      print('Échec de la validation du formulaire');
    }
  }
}

Validateurs courants

Exemple : règles de validation courantes

// Valider le nom d'utilisateur
String? validateUsername(String? value) {
  if (value == null || value.isEmpty) {
    return 'Veuillez saisir un nom d’utilisateur';
  }
  if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(value)) {
    return 'Ne peut contenir que des lettres, des chiffres et des traits de soulignement';
  }
  return null;
}

// Valider l'e-mail
String? validateEmail(String? value) {
  if (value == null || value.isEmpty) {
    return 'Veuillez saisir une adresse e-mail';
  }
  final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
  if (!emailRegex.hasMatch(value)) {
    return Veuillez saisir une adresse e-mail valide;
  }
  return null;
}

// Valider la robustesse du mot de passe
String? validatePassword(String? value) {
  if (value == null || value.isEmpty) {
    return 'Veuillez saisir le mot de passe';
  }
  if (value.length < 8) {
    return 'Le mot de passe doit contenir au moins 8 caractères';
  }
  if (!RegExp(r'[A-Z]').hasMatch(value)) {
    return 'Le mot de passe doit contenir au moins une lettre majuscule';
  }
  if (!RegExp(r'[0-9]').hasMatch(value)) {
    return 'Le mot de passe doit contenir au moins un chiffre';
  }
  return null;
}

// Valider le numéro de téléphone
String? validatePhone(String? value) {
  if (value == null || value.isEmpty) {
    return 'Veuillez saisir le numéro de téléphone';
  }
  final phoneRegex = RegExp(r'^1[3-9]\d{9}$');
  if (!phoneRegex.hasMatch(value)) {
    return 'Veuillez saisir un numéro de téléphone valide';
  }
  return null;
}

// Vérifier que les mots de passe correspondent
String? validateConfirmPassword(String? value, String password) {
  if (value == null || value.isEmpty) {
    return 'Veuillez confirmer le mot de passe';
  }
  if (value != password) {
    return 'Les deux mots de passe ne correspondent pas';
  }
  return null;
}

Exemple complexe

Exemple : formulaire d'inscription

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

  @override
  State<RegisterForm> createState() => _RegisterFormState();
}

class _RegisterFormState extends State<RegisterForm> {
  final _formKey = GlobalKey<FormState>();
  final _usernameController = TextEditingController();
  final _emailController = TextEditingController();
  final _phoneController = TextEditingController();
  final _passwordController = TextEditingController();
  final _confirmPasswordController = TextEditingController();

  bool _acceptTerms = false;

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          // Nom d'utilisateur
          TextFormField(
            controller: _usernameController,
            decoration: const InputDecoration(labelText: Nom d'utilisateur),
            validator: validateUsername,
          ),
          const SizedBox(height: 16),
          // E-mail
          TextFormField(
            controller: _emailController,
            keyboardType: TextInputType.emailAddress,
            decoration: const InputDecoration(labelText: E-mail),
            validator: validateEmail,
          ),
          const SizedBox(height: 16),
          // Numéro de téléphone
          TextFormField(
            controller: _phoneController,
            keyboardType: TextInputType.phone,
            decoration: const InputDecoration(labelText: 'Numéro de téléphone'),
            validator: validatePhone,
          ),
          const SizedBox(height: 16),
          // Mot de passe
          TextFormField(
            controller: _passwordController,
            obscureText: true,
            decoration: const InputDecoration(labelText: Mot de passe),
            validator: validatePassword,
          ),
          const SizedBox(height: 16),
          // Confirmer le mot de passe
          TextFormField(
            controller: _confirmPasswordController,
            obscureText: true,
            decoration: const InputDecoration(labelText: Confirmer le mot de passe),
            validator: (value) => validateConfirmPassword(
              value,
              _passwordController.text,
            ),
          ),
          const SizedBox(height: 16),
          // Accepter les conditions
          CheckboxListTile(
            value: _acceptTerms,
            onChanged: (value) {
              setState(() {
                _acceptTerms = value ?? false;
              });
            },
            title: const Text(J'accepte les Conditions d'utilisation),
            controlAffinity: ListTileControlAffinity.leading,
          ),
          const SizedBox(height: 24),
          // Bouton de soumission
          ElevatedButton(
            onPressed: _acceptTerms ? _submit : null,
            child: const Text(S'inscrire),
          ),
        ],
      ),
    );
  }

  void _submit() {
    if (_formKey.currentState?.validate() ?? false) {
      // Soumettre le formulaire
      print(Inscription réussie !);
    }
  }

  @override
  void dispose() {
    _usernameController.dispose();
    _emailController.dispose();
    _phoneController.dispose();
    _passwordController.dispose();
    _confirmPasswordController.dispose();
    super.dispose();
  }
}

La validation de formulaire doit être effectuée à la fois côté client (pour l'expérience utilisateur) et côté serveur (pour la sécurité) ; ne vous fiez pas uniquement à la validation côté client.

autres extensions