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}'));
},
)
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
| Propiedades | Descripción |
|---|---|
| scrollDirection | Dirección de desplazamiento, por defecto Axis.vertical (vertical) |
| reverse | Si el desplazamiento es en orden inverso |
| padding | Relleno (padding) de la lista |
| itemExtent | Altura fija de los elementos, puede mejorar el rendimiento |
| prototypeItem | Elemento 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'),
),
);
},
),
)
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}')),
);
}),
)
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}'));
},
),
),
],
);
}
}
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,
),
),
],
)
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,
),
),
],
)
Otras extensionesSlivers 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.