跨平台开发 / 系统课时
用 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,而是理解列表渲染策略:少量内容直接构建,大量内容按需生成,让界面在数据增长时仍保持流畅。
按自己的节奏,确认真正理解。