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');
}
}
}
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;
}
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();
}
}
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),
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();
}
}
autres extensionsLa 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.