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
// 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
// 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
// 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ègles | Description |
|---|---|
| Valeur de retour | Il doit renvoyer un Widget et ne peut pas renvoyer null. |
| Paramètre | Reçoit un paramètre BuildContext, représentant la position dans l'arbre de Widgets. |
| Moment de l'appel | Première construction, reconstruction du Widget parent et changements d'état |
Exemple : exemple de méthode build
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
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
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
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
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
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'),
),
],
),
],
),
),
);
}
}