Saisie utilisateur Flutter
Cette section présentera comment gérer la saisie utilisateur dans les applications Flutter, y compris la saisie de texte, les clics sur les boutons, la gestion des formulaires, et plus encore.
TextField - Saisie de texte
TextField est le widget de saisie de texte le plus couramment utilisé dans Flutter.
Exemple : utilisation de base de TextField
// Le TextField le plus simple
TextField()
// TextField avec décoration
TextField(
decoration: const InputDecoration(
labelText: Nom d'utilisateur, // Étiquette
hintText: 'Veuillez saisir le nom d’utilisateur', // Texte indicatif
prefixIcon: Icon(Icons.person), // Icône de préfixe
),
)
// TextField avec bordure
TextField(
decoration: InputDecoration(
border: OutlineInputBorder( // Bordure extérieure
borderRadius: BorderRadius.circular(8),
),
labelText: Mot de passe,
),
obscureText: true, // Masquer le contenu saisi (cas du mot de passe)
)
// Saisie de texte multiligne
TextField(
maxLines: 3, // Nombre maximum de lignes
decoration: const InputDecoration(
hintText: 'Veuillez saisir un texte multiligne',
),
)
TextField()
// TextField avec décoration
TextField(
decoration: const InputDecoration(
labelText: Nom d'utilisateur, // Étiquette
hintText: 'Veuillez saisir le nom d’utilisateur', // Texte indicatif
prefixIcon: Icon(Icons.person), // Icône de préfixe
),
)
// TextField avec bordure
TextField(
decoration: InputDecoration(
border: OutlineInputBorder( // Bordure extérieure
borderRadius: BorderRadius.circular(8),
),
labelText: Mot de passe,
),
obscureText: true, // Masquer le contenu saisi (cas du mot de passe)
)
// Saisie de texte multiligne
TextField(
maxLines: 3, // Nombre maximum de lignes
decoration: const InputDecoration(
hintText: 'Veuillez saisir un texte multiligne',
),
)
TextEditingController - Contrôleur de texte
En utilisant TextEditingController, vous pouvez lire et contrôler le contenu de TextField.
< h2 class="example">Exemple : utilisation de TextEditingController
class TextFieldExample extends StatefulWidget {
const TextFieldExample({super.key});
@override
State<TextFieldExample> createState() => _TextFieldExampleState();
}
class _TextFieldExampleState extends State<TextFieldExample> {
// Créer le contrôleur
final TextEditingController _controller = TextEditingController();
String _displayText = '';
@override
void dispose() {
// Libérer le contrôleur
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
TextField(
controller: _controller, // Lier le contrôleur
decoration: const InputDecoration(
labelText: 'Saisir le texte',
),
onChanged: (text) {
// Écouter les modifications de texte
print('Saisie actuelle : $text');
},
),
const SizedBox(height: 20),
// Afficher le texte saisi
Text('Vous avez saisi : $_displayText'),
const SizedBox(height: 20),
ElevatedButton(
onPressed: () {
// Lire le texte
setState(() {
_displayText = _controller.text;
});
},
child: const Text('Afficher la saisie'),
),
ElevatedButton(
onPressed: () {
// Effacer le texte
_controller.clear();
},
child: const Text('Effacer'),
),
ElevatedButton(
onPressed: () {
// Définir le texte
_controller.text = 'Texte prédéfini';
},
child: const Text('Définir le texte'),
),
],
);
}
}
const TextFieldExample({super.key});
@override
State<TextFieldExample> createState() => _TextFieldExampleState();
}
class _TextFieldExampleState extends State<TextFieldExample> {
// Créer le contrôleur
final TextEditingController _controller = TextEditingController();
String _displayText = '';
@override
void dispose() {
// Libérer le contrôleur
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
TextField(
controller: _controller, // Lier le contrôleur
decoration: const InputDecoration(
labelText: 'Saisir le texte',
),
onChanged: (text) {
// Écouter les modifications de texte
print('Saisie actuelle : $text');
},
),
const SizedBox(height: 20),
// Afficher le texte saisi
Text('Vous avez saisi : $_displayText'),
const SizedBox(height: 20),
ElevatedButton(
onPressed: () {
// Lire le texte
setState(() {
_displayText = _controller.text;
});
},
child: const Text('Afficher la saisie'),
),
ElevatedButton(
onPressed: () {
// Effacer le texte
_controller.clear();
},
child: const Text('Effacer'),
),
ElevatedButton(
onPressed: () {
// Définir le texte
_controller.text = 'Texte prédéfini';
},
child: const Text('Définir le texte'),
),
],
);
}
}
Contrôle du focus
L'utilisation de FocusNode vous permet de contrôler le focus des champs de saisie.
Exemple : Contrôle du focus
class FocusExample extends StatefulWidget {
const FocusExample({super.key});
@override
State<FocusExample> createState() => _FocusExampleState();
}
class _FocusExampleState extends State<FocusExample> {
final FocusNode _focusNode1 = FocusNode();
final FocusNode _focusNode2 = FocusNode();
@override
void dispose() {
_focusNode1.dispose();
_focusNode2.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
TextField(
focusNode: _focusNode1,
decoration: const InputDecoration(labelText: 'Champ de saisie 1'),
),
const SizedBox(height: 10),
TextField(
focusNode: _focusNode2,
decoration: const InputDecoration(labelText: 'Champ de saisie 2'),
),
const SizedBox(height: 20),
ElevatedButton(
onPressed: () {
// Placer le focus sur le champ de saisie 1
_focusNode1.requestFocus();
},
child: const Text('Placer le focus sur le champ de saisie 1'),
),
ElevatedButton(
onPressed: () {
// Placer le focus sur le champ de saisie 2
_focusNode2.requestFocus();
},
child: const Text('Placer le focus sur le champ de saisie 2'),
),
ElevatedButton(
onPressed: () {
// Retirer le focus
_focusNode1.unfocus();
_focusNode2.unfocus();
},
child: const Text('Retirer le focus'),
),
],
);
}
}
const FocusExample({super.key});
@override
State<FocusExample> createState() => _FocusExampleState();
}
class _FocusExampleState extends State<FocusExample> {
final FocusNode _focusNode1 = FocusNode();
final FocusNode _focusNode2 = FocusNode();
@override
void dispose() {
_focusNode1.dispose();
_focusNode2.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
TextField(
focusNode: _focusNode1,
decoration: const InputDecoration(labelText: 'Champ de saisie 1'),
),
const SizedBox(height: 10),
TextField(
focusNode: _focusNode2,
decoration: const InputDecoration(labelText: 'Champ de saisie 2'),
),
const SizedBox(height: 20),
ElevatedButton(
onPressed: () {
// Placer le focus sur le champ de saisie 1
_focusNode1.requestFocus();
},
child: const Text('Placer le focus sur le champ de saisie 1'),
),
ElevatedButton(
onPressed: () {
// Placer le focus sur le champ de saisie 2
_focusNode2.requestFocus();
},
child: const Text('Placer le focus sur le champ de saisie 2'),
),
ElevatedButton(
onPressed: () {
// Retirer le focus
_focusNode1.unfocus();
_focusNode2.unfocus();
},
child: const Text('Retirer le focus'),
),
],
);
}
}
Boutons et événements de clic
Flutter fournit une variété de composants de bouton pour gérer les clics de l'utilisateur.
Exemple : divers boutons
// TextButton - bouton texte
TextButton(
onPressed: () => print('Clic sur le bouton texte'),
child: const Text('Bouton texte'),
)
// ElevatedButton - bouton surélevé
ElevatedButton(
onPressed: () => print('Clic sur le bouton surélevé'),
child: const Text('Envoyer'),
)
// OutlinedButton - bouton avec contour
OutlinedButton(
onPressed: () => print('Clic sur le bouton avec contour'),
child: const Text('Annuler'),
)
// IconButton - bouton à icône
IconButton(
icon: const Icon(Icons.favorite),
onPressed: () => print('Clic sur le bouton à icône'),
)
// Bouton avec icône
ElevatedButton.icon(
onPressed: () => print('Clic sur le bouton avec icône'),
icon: const Icon(Icons.save),
label: const Text('Enregistrer'),
)
// CupertinoButton - bouton de style iOS
CupertinoButton(
child: const Text('bouton iOS'),
onPressed: () {},
)
TextButton(
onPressed: () => print('Clic sur le bouton texte'),
child: const Text('Bouton texte'),
)
// ElevatedButton - bouton surélevé
ElevatedButton(
onPressed: () => print('Clic sur le bouton surélevé'),
child: const Text('Envoyer'),
)
// OutlinedButton - bouton avec contour
OutlinedButton(
onPressed: () => print('Clic sur le bouton avec contour'),
child: const Text('Annuler'),
)
// IconButton - bouton à icône
IconButton(
icon: const Icon(Icons.favorite),
onPressed: () => print('Clic sur le bouton à icône'),
)
// Bouton avec icône
ElevatedButton.icon(
onPressed: () => print('Clic sur le bouton avec icône'),
icon: const Icon(Icons.save),
label: const Text('Enregistrer'),
)
// CupertinoButton - bouton de style iOS
CupertinoButton(
child: const Text('bouton iOS'),
onPressed: () {},
)
Switch, Checkbox, Radio
Exemple : Switch, Checkbox, bouton radio
class SwitchCheckboxExample extends StatefulWidget {
const SwitchCheckboxExample({super.key});
@override
State<SwitchCheckboxExample> createState() => _SwitchCheckboxExampleState();
}
class _SwitchCheckboxExampleState extends State<SwitchCheckboxExample> {
bool _switchValue = false;
bool _checkboxValue = false;
String _radioValue = 'A';
@override
Widget build(BuildContext context) {
return Column(
children: [
// Switch - basculer
Switch(
value: _switchValue,
onChanged: (value) {
setState(() {
_switchValue = value;
});
},
),
Text('Valeur de l'interrupteur: $_switchValue'),
// Checkbox - case à cocher
Case à cocher(
value: _checkboxValue,
onChanged: (value) {
setState(() {
_checkboxValue = value ?? false;
});
},
),
Text('Valeur de la case à cocher: $_checkboxValue'),
// Radio - bouton radio
Row(
children: [
Radio<String>(
value: 'A',
groupValue: _radioValue,
onChanged: (value) {
setState(() {
_radioValue = value!;
});
},
),
const Text('Option A'),
Radio<String>(
value: 'B',
groupValue: _radioValue,
onChanged: (value) {
setState(() {
_radioValue = value!;
});
},
),
const Text('Option B'),
],
),
Text('Valeur radio : $_radioValue'),
],
);
}
}
const SwitchCheckboxExample({super.key});
@override
State<SwitchCheckboxExample> createState() => _SwitchCheckboxExampleState();
}
class _SwitchCheckboxExampleState extends State<SwitchCheckboxExample> {
bool _switchValue = false;
bool _checkboxValue = false;
String _radioValue = 'A';
@override
Widget build(BuildContext context) {
return Column(
children: [
// Switch - basculer
Switch(
value: _switchValue,
onChanged: (value) {
setState(() {
_switchValue = value;
});
},
),
Text('Valeur de l'interrupteur: $_switchValue'),
// Checkbox - case à cocher
Case à cocher(
value: _checkboxValue,
onChanged: (value) {
setState(() {
_checkboxValue = value ?? false;
});
},
),
Text('Valeur de la case à cocher: $_checkboxValue'),
// Radio - bouton radio
Row(
children: [
Radio<String>(
value: 'A',
groupValue: _radioValue,
onChanged: (value) {
setState(() {
_radioValue = value!;
});
},
),
const Text('Option A'),
Radio<String>(
value: 'B',
groupValue: _radioValue,
onChanged: (value) {
setState(() {
_radioValue = value!;
});
},
),
const Text('Option B'),
],
),
Text('Valeur radio : $_radioValue'),
],
);
}
}
Slider - Slider
Exemple : Utilisation de Slider
class SliderExample extends StatefulWidget {
const SliderExample({super.key});
@override
State<SliderExample> createState() => _SliderExampleState();
}
class _SliderExampleState extends State<SliderExample> {
double _sliderValue = 0.5;
@override
Widget build(BuildContext context) {
return Column(
children: [
Slider(
value: _sliderValue, // Valeur actuelle (0.0-1.0)
min: 0.0,
max: 1.0,
divisions: 10, // Diviser en 10 graduations
label: '${(_sliderValue * 100).round()}%',
onChanged: (value) {
setState(() {
_sliderValue = value;
});
},
),
Text('Valeur actuelle : ${(_sliderValue * 100).round()}%'),
// Curseur de plage
RangeSlider(
values: const RangeValues(0.3, 0.7),
min: 0.0,
max: 1.0,
onChanged: (values) {
print('Plage : ${values.start} - ${values.end}');
},
),
],
);
}
}
const SliderExample({super.key});
@override
State<SliderExample> createState() => _SliderExampleState();
}
class _SliderExampleState extends State<SliderExample> {
double _sliderValue = 0.5;
@override
Widget build(BuildContext context) {
return Column(
children: [
Slider(
value: _sliderValue, // Valeur actuelle (0.0-1.0)
min: 0.0,
max: 1.0,
divisions: 10, // Diviser en 10 graduations
label: '${(_sliderValue * 100).round()}%',
onChanged: (value) {
setState(() {
_sliderValue = value;
});
},
),
Text('Valeur actuelle : ${(_sliderValue * 100).round()}%'),
// Curseur de plage
RangeSlider(
values: const RangeValues(0.3, 0.7),
min: 0.0,
max: 1.0,
onChanged: (values) {
print('Plage : ${values.start} - ${values.end}');
},
),
],
);
}
}
autres extensionsLors de la gestion des saisies utilisateur, n'oubliez pas d'utiliser setState pour mettre à jour l'état de l'interface utilisateur afin que celle-ci puisse réagir aux actions de l'utilisateur.