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

СвойствоОписание
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'),
        ),
      );
    },
  ),
)

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

Управление прокруткой

С помощью 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}'));
            },
          ),
        ),
      ],
    );
  }
}

Продвинутая прокрутка с 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,
      ),
    ),
  ],
)

Slivers обеспечивают эффективный способ обработки большого количества прокручиваемых элементов; они отображают только элементы в видимой области, что обеспечивает хорошую производительность.

Другие расширения