跨平台开发 / 系统课时

处理列表分组和分隔内容

处理列表分组和分隔内容

真实应用中的列表通常不是简单的一组相同数据,而是包含日期标题、分类标题、广告项或不同类型内容的信息流。本篇学习如何组织分组列表,并使用 Flutter 组合不同 item 类型。

学习目标

  • 理解分组列表的结构设计方式
  • 掌握列表项和分隔内容的组合实现
  • 能处理多类型信息流页面

分组列表的核心思路

分组列表本质上是把多个数据类型映射为可滚动组件。例如聊天记录可能按日期分组,商品页面可能按分类展示。

不要为了显示标题而创建多个嵌套列表。多个滚动容器同时存在会增加滚动冲突和性能问题。更常见的方式是把标题、内容项统一转换为一个列表数据源。

例如一个信息流可以抽象为:

  • 分组标题 item
  • 普通内容 item
  • 分隔 item

最终交给一个 ListView.builder 处理滚动。

使用不同 item 类型组织列表

下面示例通过类型字段区分标题和内容,让一个列表同时展示不同组件。

dart
import 'package:flutter/material.dart';

void main() {
  runApp(const MaterialApp(home: GroupListPage()));
}

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

  @override
  Widget build(BuildContext context) {
    final items = [
      {'type': 'header', 'text': '今天'},
      {'type': 'message', 'text': '完成 Flutter 学习'},
      {'type': 'message', 'text': '提交代码'},
      {'type': 'header', 'text': '昨天'},
      {'type': 'message', 'text': '整理页面布局'},
    ];

    return Scaffold(
      body: ListView.builder(
        itemCount: items.length,
        itemBuilder: (context, index) {
          final item = items[index];

          if (item['type'] == 'header') {
            return Padding(
              padding: const EdgeInsets.all(16),
              child: Text(
                item['text']!,
                style: const TextStyle(fontWeight: FontWeight.bold),
              ),
            );
          }

          return ListTile(title: Text(item['text']!));
        },
      ),
    );
  }
}

预期结果

text
列表显示两个日期标题。
标题和消息项位于同一个滚动列表中。
滚动时不会出现多个 ListView 嵌套导致的问题。

使用 separated 添加统一分隔内容

当所有列表项之间都有相同分隔规则时,可以使用 ListView.separated。

dart
ListView.separated(
  itemCount: messages.length,
  itemBuilder: (context, index) {
    return ListTile(title: Text(messages[index]));
  },
  separatorBuilder: (context, index) {
    return const Divider();
  },
)

预期结果

text
每两个列表项之间自动显示 Divider。
列表项仍然采用按需创建方式。

separated 适合固定分隔线、间距组件等场景。如果分隔内容需要根据前后 item 动态变化,应回到统一数据源模型中处理。

处理复杂信息流时的设计建议

复杂页面通常包含多种组件,例如文章流可能包含日期标题、文章卡片、推荐模块。此时不要让页面层判断大量业务条件,而应该在数据转换阶段完成类型整理。

例如接口数据可以先转换成 UI 模型:

数据类型 对应组件
groupHeader 分组标题
content 内容卡片
separator 分隔组件

这样列表渲染层只负责根据类型选择组件,业务变化时更容易扩展。

分组列表设计的关键不是增加更多 Widget,而是建立清晰的数据模型,让滚动容器能够稳定管理所有可见内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理列表分组和分隔内容

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通