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',
  ),
)

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'),
        ),
      ],
    );
  }
}

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'),
        ),
      ],
    );
  }
}

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: () {},
)

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'),
      ],
    );
  }
}

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}');
          },
        ),
      ],
    );
  }
}

Lors 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.

autres extensions