Flutter ListView и прокрутка
ListView — наиболее часто используемый виджет прокручиваемого списка во Flutter, предназначенный для отображения прокручиваемых списков содержимого.
Базовое использование ListView
Пример: базовое использование ListView
// Способ 1: параметр children (подходит для небольшого количества элементов)
ListView(
children: [
ListTile(title: Text('Первый элемент')),
ListTile(title: Text('Второй элемент')),
ListTile(title: Text('Третий элемент')),
],
)
// Способ 2: ListView.builder (подходит для больших или бесконечных списков)
ListView.builder(
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
)
// Способ 3: ListView.separated (с разделителями)
ListView.separated(
itemCount: 10,
separatorBuilder: (context, index) => const Divider(), // Divider
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
)
ListView(
children: [
ListTile(title: Text('Первый элемент')),
ListTile(title: Text('Второй элемент')),
ListTile(title: Text('Третий элемент')),
],
)
// Способ 2: ListView.builder (подходит для больших или бесконечных списков)
ListView.builder(
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
)
// Способ 3: ListView.separated (с разделителями)
ListView.separated(
itemCount: 10,
separatorBuilder: (context, index) => const Divider(), // Divider
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
)
Общие свойства ListView
| Свойство | Описание |
|---|---|
| scrollDirection | Направление прокрутки, по умолчанию Axis.vertical (вертикальное). |
| reverse | Следует ли обратить прокрутку |
| padding | Внутренние отступы списка |
| itemExtent | Фиксированная высота элемента для лучшей производительности |
| prototypeItem | Прототип элемента для вычисления высоты |
Пример: горизонтальный ListView
// Список с горизонтальной прокруткой
SizedBox(
height: 120, // Необходимо задать height
child: ListView.builder(
scrollDirection: Axis.horizontal, // Горизонтальная прокрутка
itemCount: 20,
itemBuilder: (context, index) {
return Container(
width: 100,
margin: const EdgeInsets.symmetric(horizontal: 8),
color: Colors.blue[100],
child: Center(
child: Text('Item $index'),
),
);
},
),
)
SizedBox(
height: 120, // Необходимо задать height
child: ListView.builder(
scrollDirection: Axis.horizontal, // Горизонтальная прокрутка
itemCount: 20,
itemBuilder: (context, index) {
return Container(
width: 100,
margin: const EdgeInsets.symmetric(horizontal: 8),
color: Colors.blue[100],
child: Center(
child: Text('Item $index'),
),
);
},
),
)
GridView - Сеточный макет
GridView используется для создания двумерных сеточных списков.
Пример: использование GridView
// GridView.count - фиксированное количество столбцов
GridView.count(
crossAxisCount: 3, // 3 столбца
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.blue[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
// GridView.builder - динамическое построение
GridView.builder(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 4, // 4 столбца
mainAxisSpacing: 8, // Вертикальный интервал
crossAxisSpacing: 8, // Горизонтальный интервал
childAspectRatio: 1, // Соотношение сторон
),
itemCount: 50,
itemBuilder: (context, index) {
return Container(
color: Colors.green[100],
child: Center(child: Text('${index + 1}')),
);
},
)
// GridView.extent - адаптивное количество столбцов
GridView.extent(
maxCrossAxisExtent: 150, // Максимальная ширина столбца
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 столбца
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.blue[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
// GridView.builder - динамическое построение
GridView.builder(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 4, // 4 столбца
mainAxisSpacing: 8, // Вертикальный интервал
crossAxisSpacing: 8, // Горизонтальный интервал
childAspectRatio: 1, // Соотношение сторон
),
itemCount: 50,
itemBuilder: (context, index) {
return Container(
color: Colors.green[100],
child: Center(child: Text('${index + 1}')),
);
},
)
// GridView.extent - адаптивное количество столбцов
GridView.extent(
maxCrossAxisExtent: 150, // Максимальная ширина столбца
children: List.generate(20, (index) {
return Container(
margin: const EdgeInsets.all(4),
color: Colors.orange[100],
child: Center(child: Text('${index + 1}')),
);
}),
)
Управление прокруткой
С помощью ScrollController можно управлять положением прокрутки.
Пример: Управление прокруткой
class ScrollExample extends StatefulWidget {
const ScrollExample({super.key});
@override
State<ScrollExample> createState() => _ScrollExampleState();
}
class _ScrollExampleState extends State<ScrollExample> {
// Создать контроллер прокрутки
late ScrollController _controller;
@override
void initState() {
super.initState();
_controller = ScrollController();
// Слушать события прокрутки
_controller.addListener(() {
print('Позиция прокрутки: ${_controller.offset});
});
}
@override
void dispose() {
// Освободить контроллер
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
// Кнопка прокрутки вверх
ElevatedButton(
onPressed: () {
// Прокрутить вверх
_controller.animateTo(
0,
duration: const Duration(milliseconds: 500),
curve: Curves.easeInOut,
);
},
child: const Text('Прокрутить вверх'),
),
// Список
Expanded(
child: ListView.builder(
controller: _controller, // Привязать контроллер
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
),
),
],
);
}
}
const ScrollExample({super.key});
@override
State<ScrollExample> createState() => _ScrollExampleState();
}
class _ScrollExampleState extends State<ScrollExample> {
// Создать контроллер прокрутки
late ScrollController _controller;
@override
void initState() {
super.initState();
_controller = ScrollController();
// Слушать события прокрутки
_controller.addListener(() {
print('Позиция прокрутки: ${_controller.offset});
});
}
@override
void dispose() {
// Освободить контроллер
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Column(
children: [
// Кнопка прокрутки вверх
ElevatedButton(
onPressed: () {
// Прокрутить вверх
_controller.animateTo(
0,
duration: const Duration(milliseconds: 500),
curve: Curves.easeInOut,
);
},
child: const Text('Прокрутить вверх'),
),
// Список
Expanded(
child: ListView.builder(
controller: _controller, // Привязать контроллер
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('Элемент ${index + 1}'));
},
),
),
],
);
}
}
Продвинутая прокрутка с Slivers
CustomScrollView в сочетании с Slivers позволяет добиться более сложных эффектов прокрутки.
Пример: эффект сворачивания Slivers
// Прокручиваемое представление со сворачиваемой панелью приложения
CustomScrollView(
slivers: [
// Свернуть панель приложения
SliverAppBar(
expandedHeight: 200, // Развёрнутая высота
pinned: true, // Закреплено сверху
flexibleSpace: FlexibleSpaceBar(
title: const Text('Сворачиваемый заголовок'),
background: Container(
decoration: BoxDecoration(
gradient: LinearGradient(
colors: [Colors.blue, Colors.purple],
begin: Alignment.topLeft,
end: Alignment.bottomRight,
),
),
),
),
),
// Содержимое списка
SliverList(
delegate: SliverChildBuilderDelegate(
(context, index) => ListTile(title: Text('Элемент ${index + 1}')),
childCount: 30,
),
),
],
)
// Сетка Sliver
CustomScrollView(
slivers: [
const SliverAppBar(
title: Text('Сетка изображений'),
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: [
// Свернуть панель приложения
SliverAppBar(
expandedHeight: 200, // Развёрнутая высота
pinned: true, // Закреплено сверху
flexibleSpace: FlexibleSpaceBar(
title: const Text('Сворачиваемый заголовок'),
background: Container(
decoration: BoxDecoration(
gradient: LinearGradient(
colors: [Colors.blue, Colors.purple],
begin: Alignment.topLeft,
end: Alignment.bottomRight,
),
),
),
),
),
// Содержимое списка
SliverList(
delegate: SliverChildBuilderDelegate(
(context, index) => ListTile(title: Text('Элемент ${index + 1}')),
childCount: 30,
),
),
],
)
// Сетка Sliver
CustomScrollView(
slivers: [
const SliverAppBar(
title: Text('Сетка изображений'),
pinned: true,
),
SliverGrid(
gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 2,
),
delegate: SliverChildBuilderDelegate(
(context, index) => Card(
child: Image.network('https://picsum.photos/200?$index'),
),
childCount: 20,
),
),
],
)
Другие расширенияSlivers обеспечивают эффективный способ обработки большого количества прокручиваемых элементов; они отображают только элементы в видимой области, что обеспечивает хорошую производительность.