帶間隔專案的列表

也許你希望建立一個列表，其中所有列表項都均勻分佈，以便這些項佔據可見空間。例如，下圖中的四個項均勻分佈，“項 0”在頂部，“項 3”在底部。

同時，你可能希望當列表項不適合時允許使用者滾動瀏覽列表，這可能是因為裝置太小、使用者調整了視窗大小，或者專案數量超出了螢幕大小。

通常，你使用 Spacer 來調整小部件之間的間距，或者使用 Expanded 來擴充套件小部件以填充可用空間。但是，這些解決方案在可滾動小部件中是不可行的，因為它們需要一個有限的高度約束。

本教程演示瞭如何使用 LayoutBuilder 和 ConstrainedBox，透過以下步驟在有足夠空間時均勻地間隔列表項，並在空間不足時允許使用者滾動

1. 新增一個帶 SingleChildScrollView 的 LayoutBuilder。
2. 在 SingleChildScrollView 中新增一個 ConstrainedBox。
3. 建立一個帶間隔專案的 Column。

首先建立一個 LayoutBuilder。你需要提供一個帶兩個引數的 builder 回撥函式

1. LayoutBuilder 提供的 BuildContext。
2. 父小部件的 BoxConstraints。

在本教程中，你不會使用 BuildContext，但在下一步中你需要 BoxConstraints。

在 builder 函式中，返回一個 SingleChildScrollView。這個小部件確保子小部件可以滾動，即使父容器太小。

LayoutBuilder(
  builder: (context, constraints) {
    return SingleChildScrollView(child: Placeholder());
  },
);

在此步驟中，新增一個 ConstrainedBox 作為 SingleChildScrollView 的子級。

ConstrainedBox 小部件對其子級施加額外的約束。

透過將 minHeight 引數設定為 LayoutBuilder 約束的 maxHeight 來配置約束。

這確保子小部件被約束為具有一個最小高度，該高度等於 LayoutBuilder 約束提供的可用空間，即 BoxConstraints 的最大高度。

LayoutBuilder(
  builder: (context, constraints) {
    return SingleChildScrollView(
      child: ConstrainedBox(
        constraints: BoxConstraints(minHeight: constraints.maxHeight),
        child: Placeholder(),
      ),
    );
  },
);

但是，你不需要設定 maxHeight 引數，因為你需要允許子級大於 LayoutBuilder 大小，以防專案不適合螢幕。

最後，新增一個 Column 作為 ConstrainedBox 的子級。

為了均勻地間隔專案，將 mainAxisAlignment 設定為 MainAxisAlignment.spaceBetween。

LayoutBuilder(
  builder: (context, constraints) {
    return SingleChildScrollView(
      child: ConstrainedBox(
        constraints: BoxConstraints(minHeight: constraints.maxHeight),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceBetween,
          children: [
            ItemWidget(text: 'Item 1'),
            ItemWidget(text: 'Item 2'),
            ItemWidget(text: 'Item 3'),
          ],
        ),
      ),
    );
  },
);

或者，如果你希望某個小部件佔據比其他小部件更多的空間，可以使用 Spacer 小部件來調整專案之間的間距，或者使用 Expanded 小部件。

為此，你必須用 IntrinsicHeight 小部件包裝 Column，這會強制 Column 小部件將自身調整為最小高度，而不是無限擴充套件。

LayoutBuilder(
  builder: (context, constraints) {
    return SingleChildScrollView(
      child: ConstrainedBox(
        constraints: BoxConstraints(minHeight: constraints.maxHeight),
        child: IntrinsicHeight(
          child: Column(
            children: [
              ItemWidget(text: 'Item 1'),
              Spacer(),
              ItemWidget(text: 'Item 2'),
              Expanded(child: ItemWidget(text: 'Item 3')),
            ],
          ),
        ),
      ),
    );
  },
);

此示例顯示了一個在列中均勻間隔的專案列表。當專案不適合螢幕時，列表可以上下滾動。專案數量由變數 items 定義，更改此值以檢視當專案不適合螢幕時會發生什麼。

import 'package:flutter/material.dart';

void main() => runApp(const SpacedItemsList());

class SpacedItemsList extends StatelessWidget {
  const SpacedItemsList({super.key});

  @override
  Widget build(BuildContext context) {
    const items = 4;

    return MaterialApp(
      title: 'Flutter Demo',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        cardTheme: CardThemeData(color: Colors.blue.shade50),
      ),
      home: Scaffold(
        body: LayoutBuilder(
          builder: (context, constraints) {
            return SingleChildScrollView(
              child: ConstrainedBox(
                constraints: BoxConstraints(minHeight: constraints.maxHeight),
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.spaceBetween,
                  crossAxisAlignment: CrossAxisAlignment.stretch,
                  children: List.generate(
                    items,
                    (index) => ItemWidget(text: 'Item $index'),
                  ),
                ),
              ),
            );
          },
        ),
      ),
    );
  }
}

class ItemWidget extends StatelessWidget {
  const ItemWidget({super.key, required this.text});

  final String text;

  @override
  Widget build(BuildContext context) {
    return Card(
      child: SizedBox(height: 100, child: Center(child: Text(text))),
    );
  }
}