跳到主內容

處理長列表

使用 ListView.builder 實現長列表或無限列表。

標準的 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