Flutter分组列表插件grouped_list的使用

Grouped list package for Flutter

Flutter中的ListView，其中列表项可以被分组成部分。

Features

• 支持空安全！
• 易于创建聊天对话框。
• 列表项可以在组中分离。
• 可以为组设置单独的标题。
• 几乎所有来自ListView.builder的字段都可用。

Getting Started

添加依赖

在您的pubspec.yaml文件中添加此包：

dependencies:
  grouped_list: ^6.0.0

在您的Dart文件中导入库：

import 'package:grouped_list/grouped_list.dart';

用GroupedListView Widget 替代 ListView 创建：

GroupedListView<dynamic, String>(
  elements: _elements,
  groupBy: (element) => element['group'],
  groupSeparatorBuilder: (String groupByValue) => Text(groupByValue),
  itemBuilder: (context, dynamic element) => Text(element['name']),
  itemComparator: (item1, item2) => item1['name'].compareTo(item2['name']), // optional
  useStickyGroupSeparators: true, // optional
  floatingHeader: true, // optional
  order: GroupedListOrder.ASC, // optional
  footer: Text("Widget at the bottom of list"), // optional
),

参数

ListView.builder的所有字段也可以使用。

Highlight - SilverGroupedList

现在支持基于银色列表的分组列表。只需使用SilverGroupedListView代替GroupedListView。示例可以在example/lib/example_silver下找到。 注意，GroupedListView的一些选项目前在SilverGroupedListView中不可用。

Highlight - Chat Dialog

轻松创建聊天对话框。 只需将选项reverse设置为true并将order设置为GroupedListOrder.DESC。完整示例可以在示例中找到。 列表将在初始状态下滚动到底部，因此滚动将与阅读方向相反。

示例代码

以下是完整的示例代码：

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

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

List _elements = [
  {'name': 'John', 'group': 'Team A'},
  {'name': 'Will', 'group': 'Team B'},
  {'name': 'Beth', 'group': 'Team A'},
  {'name': 'Miranda', 'group': 'Team B'},
  {'name': 'Mike', 'group': 'Team C'},
  {'name': 'Danny', 'group': 'Team C'},
];

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Grouped List View Example'),
        ),
        body: _createGroupedListView(),
      ),
    );
  }

  _createGroupedListView() {
    return GroupedListView<dynamic, String>(
      elements: _elements,
      groupBy: (element) => element['group'],
      groupComparator: (value1, value2) => value2.compareTo(value1),
      itemComparator: (item1, item2) => item1['name'].compareTo(item2['name']),
      order: GroupedListOrder.DESC,
      useStickyGroupSeparators: true,
      groupSeparatorBuilder: (String value) => Padding(
        padding: const EdgeInsets.all(8.0),
        child: Text(
          value,
          textAlign: TextAlign.center,
          style: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
        ),
      ),
      itemBuilder: (c, element) {
        return Card(
          elevation: 8.0,
          margin: const EdgeInsets.symmetric(horizontal: 10.0, vertical: 6.0),
          child: SizedBox(
            child: ListTile(
              contentPadding: const EdgeInsets.symmetric(horizontal: 20.0, vertical: 10.0),
              leading: const Icon(Icons.account_circle),
              title: Text(element['name']),
              trailing: const Icon(Icons.arrow_forward),
            ),
          ),
        );
      },
    );
  }
}

通过以上内容，您可以了解如何使用grouped_list插件来创建分组列表，并根据需要进行自定义。希望这对您有所帮助！