跨平台开发 / 系统课时

用 ListView 构建滚动列表

用 ListView 构建滚动列表

本篇解决 Flutter 页面展示大量重复内容时的列表构建问题。通过 ListView 与 ListView.builder,可以创建可滚动页面,并理解为什么长列表通常应该采用按需创建子项的方式。

学习目标

  • 理解 ListView 的滚动布局特点
  • 掌握 ListView.builder 创建动态列表的方法
  • 能根据数据规模选择合适的列表实现方式

理解 ListView 的滚动机制

ListView 是 Flutter 中最常用的滚动容器,它会沿垂直或水平方向排列多个子组件,并在内容超过可视区域时提供滚动能力。

简单列表可以直接传入 children:

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MaterialApp(home: SimpleListPage()));
}

class SimpleListPage extends StatelessWidget {
  const SimpleListPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: ListView(
        children: const [
          ListTile(title: Text('Flutter')),
          ListTile(title: Text('Dart')),
          ListTile(title: Text('Widget')),
        ],
      ),
    );
  }
}

预期结果

text
页面显示三个垂直排列的列表项,并可以通过手势滚动查看内容。

使用 ListView.builder 创建长列表

当列表数据数量较大时,不建议一次性创建所有子组件。ListView.builder 采用懒加载模式,只在子项即将进入屏幕时创建对应 Widget。

这种方式可以降低初始构建成本,减少不必要的内存占用。

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MaterialApp(home: BuilderListPage()));
}

class BuilderListPage extends StatelessWidget {
  const BuilderListPage({super.key});

  @override
  Widget build(BuildContext context) {
    final items = List.generate(1000, (index) => '商品 ${index + 1}');

    return Scaffold(
      body: ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text(items[index]),
          );
        },
      ),
    );
  }
}

预期结果

text
页面可以滚动浏览 1000 个商品条目,列表项会根据滚动位置逐步创建。

ListView.builder 的关键参数

参数 作用
itemCount 列表总数量
itemBuilder 根据索引创建列表项的函数
controller 控制滚动位置
physics 配置滚动行为

其中 itemBuilder 是核心,它接收当前列表索引,并返回对应的 Widget。

数据驱动列表时,通常先准备数据集合,再通过索引映射到界面组件。

选择普通 ListView 还是 builder

两者适用场景不同:

类型 适合场景
ListView 少量固定内容,例如设置页面菜单
ListView.builder 数据数量较多或动态变化,例如商品列表、消息列表

如果列表只有几个固定元素,直接使用 children 更直观。如果数据来自接口、数据库或可能增长,应优先考虑 builder 模式。

长列表中的性能注意事项

使用 ListView.builder 时,应避免在 itemBuilder 内执行耗时操作,例如重复读取文件或进行复杂计算。

列表项应保持轻量,将复杂数据处理提前完成,再把结果传递给 Widget。对于需要分组、分页加载或下拉刷新等场景,可以结合其他列表组件进一步扩展。

掌握 ListView 的关键不是记住 API,而是理解列表渲染策略:少量内容直接构建,大量内容按需生成,让界面在数据增长时仍保持流畅。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 ListView 构建滚动列表

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通