標準的 ListView 建構函式適用於小型列表。要處理包含大量專案的列表,最好使用 ListView.builder 建構函式。

與預設的 ListView 建構函式要求一次性建立所有專案不同,ListView.builder() 建構函式會在專案滾動到螢幕上時建立它們。

1. 建立資料來源

#

首先,你需要一個數據源。例如,你的資料來源可能是一系列訊息、搜尋結果或商店中的商品。大多數情況下,這些資料來自網際網路或資料庫。

在此示例中,使用 List.generate 建構函式生成一個包含 10,000 個字串的列表。

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

2. 將資料來源轉換為元件

#

要顯示字串列表,請使用 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