带有间距项目的列表

您可能希望创建一个列表,其中所有列表项都均匀间距,以便这些项占据可见空间。例如,下图中的四个项均匀间距,其中“Item 0”位于顶部,“Item 3”位于底部。

Spaced items

同时,您可能希望允许用户在列表项不适合时滚动浏览列表,例如,设备太小、用户调整了窗口大小或项目数量超过屏幕大小。

Scrollable items

通常,您使用 Spacer 来调整小部件之间的间距,或使用 Expanded 来扩展小部件以填充可用空间。但是,这些解决方案在可滚动小部件内不可行,因为它们需要有限的高度约束。

本示例演示了如何使用 LayoutBuilderConstrainedBox 在有足够空间时均匀地间隔列表项,并在没有足够空间时允许用户滚动,具体步骤如下:

  1. 添加一个带有 SingleChildScrollViewLayoutBuilder
  2. SingleChildScrollView 内添加一个 ConstrainedBox
  3. 创建一个带有间隔项的 Column

1. 添加一个带有 SingleChildScrollViewLayoutBuilder

#

首先创建一个 LayoutBuilder。您需要提供一个带有两个参数的 builder 回调函数

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

在本示例中,您不会使用 BuildContext,但您将在下一步中需要 BoxConstraints

builder 函数中,返回一个 SingleChildScrollView。此部件确保子部件可以滚动,即使父容器太小。

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

2. 在 SingleChildScrollView 内添加一个 ConstrainedBox

#

在此步骤中,将 ConstrainedBox 添加为 SingleChildScrollView 的子部件。

ConstrainedBox 部件对其子部件施加额外的约束。

通过将minHeight参数设置为LayoutBuilder约束的maxHeight来配置约束。

这确保子部件被约束为具有等于LayoutBuilder约束提供的可用空间的最小高度,即BoxConstraints的最大高度。

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

但是,您不需要设置maxHeight参数,因为您需要允许子部件大于LayoutBuilder大小,以防项目不适合屏幕。

3. 创建一个带有间距项目的Column

#

最后,将Column作为ConstrainedBox的子部件添加。

为了使项目均匀间距,将mainAxisAlignment设置为MainAxisAlignment.spaceBetween

dart
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部件,如果您希望一个部件比其他部件占用更多空间。

为此,您必须将ColumnIntrinsicHeight部件包装起来,这将强制Column部件调整自身大小以达到最小高度,而不是无限扩展。

dart
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: CardTheme(color: Colors.blue.shade50),
        useMaterial3: true,
      ),
      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)),
      ),
    );
  }
}