Bases des widgets Flutter

Widget est le bloc de construction de base de l'interface utilisateur Flutter.

Dans Flutter, tout est un Widget, du simple texte aux mises en page complexes, tout est composé de Widgets.


Qu'est-ce qu'un Widget ?

Widget est une classe Dart qui décrit l'apparence et le comportement de l'interface utilisateur. Chaque application Flutter est essentiellement une structure arborescente composée de Widgets, appelée arbre de Widgets.

Exemple : l'exemple de Widget le plus simple

import 'package:flutter/material.dart';

// Définir un Widget simple
class HelloWidget extends StatelessWidget {
  const HelloWidget({super.key});

  @override
  Widget build(BuildContext context) {
    // Retourne un Widget Text qui affiche "Hello World"
    return const Text('Hello World');
  }
}

StatelessWidget - composant sans état

StatelessWidget est un Widget immuable. Une fois créé, ses propriétés ne peuvent pas être modifiées. Il convient aux scénarios qui affichent du contenu statique, comme du texte, des images, des icônes, etc.

Structure de base

Exemple : Exemple de StatelessWidget

import 'package:flutter/material.dart';

// Définir un widget sans état
class MyTextWidget extends StatelessWidget {
  // Paramètres du constructeur (propriétés immuables)
  final String text;
  final Color textColor;
  final double fontSize;

  // Utiliser un constructeur const
  const MyTextWidget({
    super.key,
    required this.text,
    this.textColor = Colors.black,
    this.fontSize = 16.0,
  });

  @override
  Widget build(BuildContext context) {
    // la méthode build renvoie un autre Widget
    return Text(
      text,
      style: TextStyle(
        color: textColor,
        fontSize: fontSize,
      ),
    );
  }
}

// Exemple d'utilisation
// MyTextWidget(text: 'Hello', textColor: Colors.red)

Scénarios applicables

  • Affichage de texte statique
  • Affichage d'image
  • Affichage d'icône
  • Mise en page qui ne change pas au fil du temps

StatefulWidget - composant avec état

StatefulWidget est un Widget mutable qui peut mettre à jour l'interface utilisateur lorsque les données internes changent. Il convient aux scénarios qui doivent répondre aux interactions de l'utilisateur ou aux changements de données.

Structure de base

Exemple : exemple de StatefulWidget

import 'package:flutter/material.dart';

// Définir un widget avec état
class CounterWidget extends StatefulWidget {
  const CounterWidget({super.key});

  @override
  State<CounterWidget> createState() => _CounterWidgetState();
}

// La classe State contient un état mutable
class _CounterWidgetState extends State<CounterWidget> {
  // État du compteur
  int _count = 0;

  // Méthode pour incrémenter le compteur
  void _increment() {
    // Appeler setState pour notifier le framework que l'état a changé
    setState(() {
      _count++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        // Afficher le compteur actuel
        Texte(
          'Counter: $_count',
          style: const TextStyle(fontSize: 24),
        ),
        const SizedBox(height: 16),
        // Bouton d'incrémentation
        ElevatedButton(
          onPressed: _increment,
          child: const Text('Increase'),
        ),
      ],
    );
  }
}

méthode setState

Dans StatefulWidget, si l'état change, vous devez appelersetStatela méthode pour notifier Flutter de reconstruire l'interface utilisateur.

Si l'état est modifié mais que setState n'est pas appelé, l'interface utilisateur ne sera pas mise à jour. Cela est dû au fait que Flutter utilise setState pour déterminer si le Widget doit être reconstruit.

Scénarios applicables

  • Données dynamiques telles que les compteurs, les minuteurs, etc.
  • Saisie de formulaire
  • Ajout, suppression et modification d'éléments de liste
  • Réponse aux interactions utilisateur

méthode build

Chaque Widget doit implémenterbuildla méthode, qui renvoie une partie de l'arbre de Widgets.

Règles de base

RèglesDescription
Valeur de retourIl doit renvoyer un Widget et ne peut pas renvoyer null.
ParamètreReçoit un paramètre BuildContext, représentant la position dans l'arbre de Widgets.
Moment de l'appelPremière construction, reconstruction du Widget parent et changements d'état

Exemple : exemple de méthode build

@override
Widget build(BuildContext context) {
  // BuildContext donne accès aux thèmes, aux informations sur le thème, etc.
  // Par exemple, obtenir la couleur du thème actuel
  final theme = Theme.of(context);

  // Renvoyer un Widget
  return Container(
    padding: const EdgeInsets.all(16.0),
    decoration: BoxDecoration(
      color: theme.colorScheme.primaryContainer,
      borderRadius: BorderRadius.circular(8),
    ),
    child: Text(
      'Hello Flutter',
      style: TextStyle(
        color: theme.colorScheme.onPrimaryContainer,
        fontSize: 20,
      ),
    ),
  );
}

Widgets de base couramment utilisés

Text - affichage de texte

Exemple : Text Widget

// Texte de base
const Text('Hello World')

// Texte avec style
Texte(
  'Hello Flutter',
  style: TextStyle(
    fontSize: 20,
    fontWeight: FontWeight.bold,
    color: Colors.blue,
  ),
)

// Texte avec style optionnel
Text.rich(
  TextSpan(
    text: 'Hello ',
    children: [
      TextSpan(
        text: 'Flutter',
        style: TextStyle(fontWeight: FontWeight.bold),
      ),
    ],
  ),
)

Icône

Exemple : widget Icon

// Utiliser les icônes Material
const Icon(Icons.home)              // Icône d'accueil
const Icon(Icons.star, color: Colors.yellow)  // Étoile colorée
const Icon(Icons.settings, size: 48)  // Icône de paramètres de taille 48

Image

Exemple : widget Image

// Charger l'image depuis le réseau
Image.network('https://example.com/image.png')

// Charger l'image depuis les ressources locales
Image.asset('assets/images/logo.png')

// Charger une image à partir d'un fichier
Image.file(File('path/to/image.png'))

// Image avec paramètres
Image.network(
  'https://example.com/image.png',
  width: 200,
  height: 200,
  fit: BoxFit.cover,
)

Bouton

Exemple : widget bouton

// Bouton texte
TextButton(
  onPressed: () { /* Gérer le clic */ },
  child: const Text('Bouton texte'),
)

// Bouton d'action flottant
FloatingActionButton(
  onPressed: () { /* Gérer le clic */ },
  child: const Icon(Icons.add),
)

// ElevatedButton - bouton avec ombre
ElevatedButton(
  onPressed: () { /* Gérer le clic */ },
  child: const Text('Envoyer'),
)

// Bouton avec icône
ElevatedButton.icon(
  onPressed: () { /* Gérer le clic */ },
  icon: const Icon(Icons.save),
  label: const Text('Enregistrer'),
)

Combinaison de widgets

La puissance de Flutter réside dans sa capacité à combiner des widgets. Grâce à l'imbrication, un widget simple peut construire une interface utilisateur complexe.

Exemple : widget composite

class MyCard extends StatelessWidget {
  const MyCard({super.key});

  @override
  Widget build(BuildContext context) {
    return Card(
      // Card est un composant de carte Material Design
      elevation: 4,  // Profondeur de l'ombre
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            // Titre
            const Text(
              'Titre de la carte',
              style: TextStyle(
                fontSize: 20,
                fontWeight: FontWeight.bold,
              ),
            ),
            const SizedBox(height: 8),
            // Texte de description
            const Text(
              'Ceci est la description de la carte, qui peut contenir plusieurs lignes de texte.',
            ),
            const SizedBox(height: 16),
            // Rangée de boutons
            Row(
              mainAxisAlignment: MainAxisAlignment.end,
              children: [
                TextButton(
                  onPressed: () {},
                  child: const Text('Annuler'),
                ),
                const SizedBox(width: 8),
                ElevatedButton(
                  onPressed: () {},
                  child: const Text('Confirm'),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}
autres extensions