Flutter可扩展分组插件expandable_group的使用

ExpandableGroup 是一个用于在 Flutter 应用程序列表中支持展开和折叠分组项的新小部件。它支持 Android、iOS、Web 和桌面平台。

构建可扩展分组小部件以支持展开和折叠分组数据。

特性

• 列表中的头部展开和折叠。
• 支持自定义头部和列表项。
• 单个 ListView。

开始使用

1. 添加依赖到项目的 pubspec.yaml 并运行 pub get

dependencies:
  expandable_group: ^0.0.6

2. 导入 expandable_group_widget.dart 到你的项目文件中

import 'package:expandable_group/expandable_group_widget.dart';

3. ExpandableGroup 的一些属性

3.1 必需的属性

• header: 显示在列表中的头部小部件。
• items: 每个分组中要显示的 ListTile 列表。

3.2 可选的属性

• isExpanded: 一个布尔值，用于展开或折叠头部。默认值为 false。
• expandedIcon 和 collapsedIcon: 扩展和折叠状态下的小部件。
• headerEdgeInsets: 头部小部件的 EdgeInsets。
• headerBackgroundColor: 自定义头部背景颜色。

4. 示例

ExpandableGroup(
    isExpanded: index == 0,
    header: _header('Group $index'),
    items: _buildItems(context, group),
    headerEdgeInsets: EdgeInsets.only(left: 16.0, right: 16.0)
)

完整示例

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  // 这个小部件是你的应用的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Expandable Group demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      debugShowCheckedModeBanner: false,
      home: MyHomePage(
        title: 'Expandable Group demo',
        data: _generateData(),
      ),
    );
  }

  List<List<String>> _generateData() {
    int numberOfGroups = 5;
    List<List<String>> results = [];
    for (int i = 0; i < numberOfGroups; i++) {
      List<String> items = [];
      for (int j = 0; j < numberOfGroups * 5 + i; j++) {
        items.add("Item $j in group $i");
      }
      results.add(items);
    }
    return results;
  }
}

class MyHomePage extends StatefulWidget {
  final List<List<String>> data;
  MyHomePage({Key? key, required this.title, required this.data}) : super(key: key);

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: ListView(
        children: [
          Column(
            children: widget.data.map((group) {
              int index = widget.data.indexOf(group);
              return ExpandableGroup(
                isExpanded: index == 0,
                header: _header('Group $index'),
                items: _buildItems(context, group),
                headerEdgeInsets: EdgeInsets.only(left: 16.0, right: 16.0),
              );
            }).toList(),
          )
        ],
      ),
    );
  }

  Widget _header(String name) => Text(name,
      style: TextStyle(
        fontSize: 16,
        fontWeight: FontWeight.bold,
      ));

  List<ListTile> _buildItems(BuildContext context, List<String> items) => items
      .map((e) => ListTile(
            title: Text(e),
          ))
      .toList();
}