标准的 ListView 构造函数适用于小型列表。要处理包含大量项目的列表,最好使用 ListView.builder 构造函数。

与默认的 ListView 构造函数需要一次性创建所有项目不同,ListView.builder() 构造函数会在项目滚动到屏幕上时创建它们。

1. 创建数据源

#

首先,你需要一个数据源。例如,你的数据源可能是一系列消息、搜索结果或商店中的商品。大多数情况下,这些数据来自互联网或数据库。

在此示例中,使用 List.generate 构造函数生成一个包含 10,000 个字符串的列表。

Dart
List<String>.generate(10000, (i) => 'Item $i'),

2. 将数据源转换为组件 (widget)

#

要显示字符串列表,可以使用 ListView.builder() 将每个字符串渲染为一个组件。在此示例中,将每个字符串显示在单独的一行上。

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

互动示例

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

void main() {
  runApp(
    MyApp(
      items: List<String>.generate(10000, (i) => 'Item $i'),
    ),
  );
}

class MyApp extends StatelessWidget {
  final List<String> items;

  const MyApp({super.key, required this.items});

  @override
  Widget build(BuildContext context) {
    const title = 'Long List';

    return MaterialApp(
      title: title,
      home: Scaffold(
        appBar: AppBar(title: const Text(title)),
        body: ListView.builder(
          itemCount: items.length,
          prototypeItem: ListTile(title: Text(items.first)),
          itemBuilder: (context, index) {
            return ListTile(title: Text(items[index]));
          },
        ),
      ),
    );
  }
}

子组件的范围

#

要指定每个项目的范围,可以使用 prototypeItemitemExtentitemExtentBuilder

指定任一属性都比让子组件自行确定其范围更高效,因为滚动机制可以利用对子组件范围的预先了解来节省工作,例如在滚动位置大幅改变时。

如果列表中的项目大小固定,请使用 prototypeItemitemExtent

如果列表中的项目大小不同,请使用 itemExtentBuilder