Flutter ListView et défilement
ListView est le widget de liste défilante le plus couramment utilisé dans Flutter, utilisé pour afficher des listes de contenu défilantes.
Utilisation de base de ListView
Exemple : Utilisation de base de ListView
// Méthode 1 : paramètre children (adapté à un petit nombre d'éléments)
ListView(
children: [
ListTile(title: Text('Premier élément')),
ListTile(title: Text('Deuxième élément')),
ListTile(title: Text('Troisième élément')),
],
)
// Méthode 2 : ListView.builder (adapté aux listes volumineuses ou infinies)
ListView.builder(
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
)
// Méthode 3 : ListView.separated (avec séparateurs)
ListView.separated(
itemCount: 10,
separatorBuilder: (context, index) => const Divider(), // Divider
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
)
ListView(
children: [
ListTile(title: Text('Premier élément')),
ListTile(title: Text('Deuxième élément')),
ListTile(title: Text('Troisième élément')),
],
)
// Méthode 2 : ListView.builder (adapté aux listes volumineuses ou infinies)
ListView.builder(
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
)
// Méthode 3 : ListView.separated (avec séparateurs)
ListView.separated(
itemCount: 10,
separatorBuilder: (context, index) => const Divider(), // Divider
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
)
Propriétés communes de ListView
| Propriété | Description |
|---|---|
| scrollDirection | Direction de défilement, par défaut Axis.vertical (vertical). |
| reverse | Indique si le défilement doit être inversé |
| padding | Marge intérieure de la liste |
| itemExtent | Hauteur d'élément fixe pour de meilleures performances |
| prototypeItem | Élément prototype pour calculer la hauteur |
Exemple : ListView horizontale
// Liste à défilement horizontal
SizedBox(
height: 120, // Il faut définir la hauteur
child: ListView.builder(
scrollDirection: Axis.horizontal, // Défilement horizontal
itemCount: 20,
itemBuilder: (context, index) {
return Container(
width: 100,
margin: const EdgeInsets.symmetric(horizontal: 8),
color: Colors.blue[100],
child: Center(
child: Text('Élément $index'),
),
);
},
),
)
SizedBox(
height: 120, // Il faut définir la hauteur
child: ListView.builder(
scrollDirection: Axis.horizontal, // Défilement horizontal
itemCount: 20,
itemBuilder: (context, index) {
return Container(
width: 100,
margin: const EdgeInsets.symmetric(horizontal: 8),
color: Colors.blue[100],
child: Center(
child: Text('Élément $index'),
),
);
},
),
)
GridView - Disposition en grille
GridView est utilisé pour créer des listes en grille bidimensionnelles.
Exemple : Utilisation de GridView
// GridView.count - nombre fixe de colonnes
GridView.count(
crossAxisCount: 3, // 3 colonnes
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.blue[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
// GridView.builder - construction dynamique
GridView.builder(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 4, // 4 colonnes
mainAxisSpacing: 8, // Espacement vertical
crossAxisSpacing: 8, // Espacement horizontal
childAspectRatio: 1, // Rapport d'aspect
),
itemCount: 50,
itemBuilder: (context, index) {
return Container(
color: Colors.green[100],
child: Center(child: Text('${index + 1}')),
);
},
)
// GridView.extent - nombre de colonnes adaptatif
GridView.extent(
maxCrossAxisExtent: 150, // Largeur maximale de colonne
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.orange[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
GridView.count(
crossAxisCount: 3, // 3 colonnes
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.blue[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
// GridView.builder - construction dynamique
GridView.builder(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 4, // 4 colonnes
mainAxisSpacing: 8, // Espacement vertical
crossAxisSpacing: 8, // Espacement horizontal
childAspectRatio: 1, // Rapport d'aspect
),
itemCount: 50,
itemBuilder: (context, index) {
return Container(
color: Colors.green[100],
child: Center(child: Text('${index + 1}')),
);
},
)
// GridView.extent - nombre de colonnes adaptatif
GridView.extent(
maxCrossAxisExtent: 150, // Largeur maximale de colonne
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.orange[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
Contrôle du défilement
En utilisant ScrollController, vous pouvez contrôler la position de défilement.
Exemple : Contrôle du défilement
class ScrollExample extends StatefulWidget {
const ScrollExample({super.key});
@override
State<ScrollExample> createState() => _ScrollExampleState();
}
class _ScrollExampleState extends State<ScrollExample> {
// Créer un contrôleur de défilement
late ScrollController _controller;
@override
void initState() {
super.initState();
_controller = ScrollController();
// Écouter les événements de défilement
_controller.addListener(() {
print('Position de défilement : ${_controller.offset});
});
}
@override
void dispose() {
// Libérer le contrôleur
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
// Bouton de défilement vers le haut
ElevatedButton(
onPressed: () {
// Défiler vers le haut
_controller.animateTo(
0,
duration: const Duration(milliseconds: 500),
curve: Curves.easeInOut,
);
},
child: const Text('Défiler vers le haut'),
),
// Liste
Expanded(
child: ListView.builder(
controller: _controller, // Lier le contrôleur
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
),
),
],
);
}
}
const ScrollExample({super.key});
@override
State<ScrollExample> createState() => _ScrollExampleState();
}
class _ScrollExampleState extends State<ScrollExample> {
// Créer un contrôleur de défilement
late ScrollController _controller;
@override
void initState() {
super.initState();
_controller = ScrollController();
// Écouter les événements de défilement
_controller.addListener(() {
print('Position de défilement : ${_controller.offset});
});
}
@override
void dispose() {
// Libérer le contrôleur
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
// Bouton de défilement vers le haut
ElevatedButton(
onPressed: () {
// Défiler vers le haut
_controller.animateTo(
0,
duration: const Duration(milliseconds: 500),
curve: Curves.easeInOut,
);
},
child: const Text('Défiler vers le haut'),
),
// Liste
Expanded(
child: ListView.builder(
controller: _controller, // Lier le contrôleur
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Élément ${index + 1}'));
},
),
),
],
);
}
}
Slivers : défilement avancé
CustomScrollView combiné avec les Slivers permet d'obtenir des effets de défilement plus complexes.
Exemple : effet de repli avec les Slivers
// Vue de défilement avec barre d'application repliable
CustomScrollView(
slivers: [
// Replier la barre d'application
SliverAppBar(
expandedHeight: 200, // Hauteur déployée
pinned: true, // Fixé en haut
flexibleSpace: FlexibleSpaceBar(
title: const Text('Titre réductible'),
background: Container(
decoration: BoxDecoration(
gradient: LinearGradient(
colors: [Colors.blue, Colors.purple],
begin: Alignment.topLeft,
end: Alignment.bottomRight,
),
),
),
),
),
// Contenu de la liste
SliverList(
delegate: SliverChildBuilderDelegate(
(context, index) => ListTile(title: Text('Élément ${index + 1}')),
childCount: 30,
),
),
],
)
// Sliver de grille
CustomScrollView(
slivers: [
const SliverAppBar(
title: Text('Grille d’images'),
pinned: true,
),
SliverGrid(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 2,
),
delegate: SliverChildBuilderDelegate(
(context, index) => Card(
child: Image.network('https://picsum.photos/200?$index'),
),
childCount: 20,
),
),
],
)
CustomScrollView(
slivers: [
// Replier la barre d'application
SliverAppBar(
expandedHeight: 200, // Hauteur déployée
pinned: true, // Fixé en haut
flexibleSpace: FlexibleSpaceBar(
title: const Text('Titre réductible'),
background: Container(
decoration: BoxDecoration(
gradient: LinearGradient(
colors: [Colors.blue, Colors.purple],
begin: Alignment.topLeft,
end: Alignment.bottomRight,
),
),
),
),
),
// Contenu de la liste
SliverList(
delegate: SliverChildBuilderDelegate(
(context, index) => ListTile(title: Text('Élément ${index + 1}')),
childCount: 30,
),
),
],
)
// Sliver de grille
CustomScrollView(
slivers: [
const SliverAppBar(
title: Text('Grille d’images'),
pinned: true,
),
SliverGrid(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 2,
),
delegate: SliverChildBuilderDelegate(
(context, index) => Card(
child: Image.network('https://picsum.photos/200?$index'),
),
childCount: 20,
),
),
],
)
autres extensionsLes Slivers offrent un moyen efficace de gérer un grand nombre d'éléments de défilement ; ils ne rendent que les éléments dans la zone visible, offrant ainsi de bonnes performances.