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

Propriétés communes de ListView

PropriétéDescription
scrollDirectionDirection de défilement, par défaut Axis.vertical (vertical).
reverseIndique si le défilement doit être inversé
paddingMarge intérieure de la liste
itemExtentHauteur 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'),
        ),
      );
    },
  ),
)

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

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

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

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

autres extensions