標準的 ListView 建構函式(constructor)非常適合用於小型清單。若要處理包含大量項目的清單,建議使用 ListView.builder 建構函式。

與預設的 ListView 建構函式不同,預設建構函式需要一次建立所有項目,而 ListView.builder() 建構函式則是在項目被捲動到螢幕上時才建立。

1. 建立資料來源

#

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

在本範例中,使用 List.generate 建構函式產生一個包含 10,000 筆字串的清單。

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

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

#

要顯示字串清單,可以使用ListView.builder(),將每個 String 渲染為一個元件(Widget)。 在此範例中,每個 String 會顯示在自己的行上。

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

子項目範圍

#

若要指定每個項目的範圍(extent),你可以使用 prototypeItemitemExtentitemExtentBuilder

明確指定範圍會比讓子項目自行決定範圍來得更有效率,因為滾動機制可以利用預先得知的子項目範圍來減少運算量,例如當滾動位置大幅變動時。

如果你的清單(list)中所有項目大小固定,請使用 prototypeItemitemExtent

如果你的清單中項目大小不一,請使用 itemExtentBuilder