Flutter ListView y desplazamiento

ListView es el Widget de lista de desplazamiento más utilizado en Flutter; se usa para mostrar listas de contenido desplazable.


Uso básico de ListView

Ejemplo: Uso básico de ListView

// Método 1: parámetro children (apto para pocos elementos)
ListView(
  children: [
    ListTile(title: Text('Primer elemento')),
    ListTile(title: Text('Segundo elemento')),
    ListTile(title: Text('Tercer elemento')),
  ],
)

// Método 2: ListView.builder (apto para listas grandes o infinitas)
ListView.builder(
  itemCount: 100,
  itemBuilder: (context, index) {
    return ListTile(title: Text('Elemento ${index + 1}'));
  },
)

// Método 3: ListView.separated (con separadores)
ListView.separated(
  itemCount: 10,
  separatorBuilder: (context, index) => const Divider(),  // Separador
  itemBuilder: (context, index) {
    return ListTile(title: Text('Elemento ${index + 1}'));
  },
)

Propiedades comunes de ListView

PropiedadesDescripción
scrollDirectionDirección de desplazamiento, por defecto Axis.vertical (vertical)
reverseSi el desplazamiento es en orden inverso
paddingRelleno (padding) de la lista
itemExtentAltura fija de los elementos, puede mejorar el rendimiento
prototypeItemElemento prototipo, utilizado para calcular la altura

Ejemplo: ListView horizontal

// Lista con desplazamiento horizontal
SizedBox(
  height: 120,  // Se debe establecer una altura
  child: ListView.builder(
    scrollDirection: Axis.horizontal,  // Desplazamiento horizontal
    itemCount: 20,
    itemBuilder: (context, index) {
      return Container(
        width: 100,
        margin: const EdgeInsets.symmetric(horizontal: 8),
        color: Colors.blue[100],
        child: Center(
          child: Text('Elemento $index'),
        ),
      );
    },
  ),
)

GridView - Diseño de cuadrícula

GridView se utiliza para crear listas de cuadrícula bidimensionales.

Ejemplo: Uso de GridView

// GridView.count - número fijo de columnas
GridView.count(
  crossAxisCount: 3,  // 3 columnas
  children: List.generate(20, (index) {
    return Container(
      margin: const EdgeInsets.all(4),
      color: Colors.blue[100],
      child: Center(child: Text('${index + 1}')),
    );
  }),
)

// GridView.builder - construcción dinámica
GridView.builder(
  gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
    crossAxisCount: 4,  // 4 columnas
    mainAxisSpacing: 8,  // Espaciado vertical
    crossAxisSpacing: 8,  // Espaciado horizontal
    childAspectRatio: 1,  // Relación de aspecto ancho/alto
  ),
  itemCount: 50,
  itemBuilder: (context, index) {
    return Container(
      color: Colors.green[100],
      child: Center(child: Text('${index + 1}')),
    );
  },
)

// GridView.extent - número de columnas adaptable
GridView.extent(
  maxCrossAxisExtent: 150,  // Ancho máximo de columna
  children: List.generate(20, (index) {
    return Container(
      margin: const EdgeInsets.all(4),
      color: Colors.orange[100],
      child: Center(child: Text('${index + 1}')),
    );
  }),
)

Control de desplazamiento

Se puede usar ScrollController para controlar la posición de desplazamiento.

Ejemplo: Control de desplazamiento

class ScrollExample extends StatefulWidget {
  const ScrollExample({super.key});

  @override
  State<ScrollExample> createState() => _ScrollExampleState();
}

class _ScrollExampleState extends State<ScrollExample> {
  // Crear el controlador de desplazamiento
  late ScrollController _controller;

  @override
  void initState() {
    super.initState();
    _controller = ScrollController();
    // Escuchar eventos de desplazamiento
    _controller.addListener(() {
      print('Posición de desplazamiento: ${_controller.offset}');
    });
  }

  @override
  void dispose() {
    // Destruir el controlador
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        // Botón para desplazarse al inicio
        ElevatedButton(
          onPressed: () {
            // Desplazarse al inicio
            _controller.animateTo(
              0,
              duration: const Duration(milliseconds: 500),
              curve: Curves.easeInOut,
            );
          },
          child: const Text('Desplazarse al inicio'),
        ),
        // Lista
        Expanded(
          child: ListView.builder(
            controller: _controller,  // Vincular el controlador
            itemCount: 100,
            itemBuilder: (context, index) {
              return ListTile(title: Text('Elemento ${index + 1}'));
            },
          ),
        ),
      ],
    );
  }
}

Slivers: Desplazamiento avanzado

CustomScrollView junto con Slivers puede lograr efectos de desplazamiento más complejos.

Ejemplo: Efecto de colapso con Slivers

// Vista de desplazamiento con AppBar plegable
CustomScrollView(
  slivers: [
    // AppBar plegable
    SliverAppBar(
      expandedHeight: 200,  // Altura expandida
      pinned: true,  // Fijado en la parte superior
      flexibleSpace: FlexibleSpaceBar(
        title: const Text('Título plegable'),
        background: Container(
          decoration: BoxDecoration(
            gradient: LinearGradient(
              colors: [Colors.blue, Colors.purple],
              begin: Alignment.topLeft,
              end: Alignment.bottomRight,
            ),
          ),
        ),
      ),
    ),
    // Contenido de la lista
    SliverList(
      delegate: SliverChildBuilderDelegate(
        (context, index) => ListTile(title: Text('Elemento ${index + 1}')),
        childCount: 30,
      ),
    ),
  ],
)

// Sliver de cuadrícula
CustomScrollView(
  slivers: [
    const SliverAppBar(
      title: Text('Cuadrícula de imágenes'),
      pinned: true,
    ),
    SliverGrid(
      gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
        crossAxisCount: 2,
      ),
      delegate: SliverChildBuilderDelegate(
        (context, index) => Card(
          child: Image.network('https://picsum.photos/200?$index'),
        ),
        childCount: 20,
      ),
    ),
  ],
)

Slivers proporcionan una forma eficiente de manejar una gran cantidad de elementos de desplazamiento; solo renderizan los elementos en el área visible, ofreciendo así un buen rendimiento.

Otras extensiones