Flutter可扩展列表项组管理插件expansion_tile_group的使用

概述

expansion_tile_group 是一个增强型的Flutter包，它解决了标准 ExpansionTile 小部件的局限性，提供了高度可定制的小部件，完全扩展了其功能。这些小部件可以无缝地分组，并且它们的交互可以轻松管理，为您提供无与伦比的控制和灵活性。

• GitHub
• Pub.dev

主要特性

项目特性

• ExpansionTileItem 完全继承了标准的 ExpansionTile 功能。
• 支持多种常见的 ExpansionTileItem UI类型：ExpansionTileOutlined、ExpansionTileFlat、ExpansionTileLeaf、ExpansionTileCard。
• 可以从任何地方控制 ExpansionTileItem 的行为（展开或折叠）。
• 可以自定义或添加装饰到 ExpansionTileItem 中，如 Border、BorderRadius、Shadow 或 BoxDecoration 等。
• 可以防止 ExpansionTileItem 展开直到任务完成。
• 可以完全移除 trailing 包括区域和箭头图标，默认情况下 ExpansionTile 无法做到这一点，使得标题可以占据整个宽度。
• 可以完全移除默认标题的垂直填充。
• 可以在 ExpansionTileItem 展开时隐藏副标题。
• 可以更改默认的尾部图标为自定义小部件，同时保持默认的旋转动画。

组特性

• 可以将 ExpansionTileItem 分组并管理它们。
• 支持多种交互行为类型：ExpandOnlyCurrent、ExpandAll、CollapseAll、ExpandAllOrCollapseAll、expandAlwaysCurrent。
• 可以监听组中项目的交互变化。
• 可以在组中的项目之间添加间距。

示例代码

以下是一个完整的示例代码，展示了如何使用 expansion_tile_group 插件创建一个带有不同交互类型的可扩展列表项组的应用程序。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Expansion Tile Group Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: ExpansionTileGroupDemo(),
    );
  }
}

class ExpansionTileGroupDemo extends StatefulWidget {
  @override
  _ExpansionTileGroupDemoState createState() => _ExpansionTileGroupDemoState();
}

class _ExpansionTileGroupDemoState extends State<ExpansionTileGroupDemo> {
  final List<String> items = ['Item 1', 'Item 2', 'Item 3'];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Expansion Tile Group Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            ExpansionTileGroup(
              toggleType: ToggleType.expandOnlyCurrent,
              children: items.map((item) {
                return ExpansionTileItem(
                  title: Text(item),
                  subtitle: Text('Subtitle for $item'),
                  leading: Icon(Icons.folder),
                  trailing: Icon(Icons.arrow_drop_down),
                  children: [
                    ListTile(
                      title: Text('Child of $item'),
                    ),
                  ],
                );
              }).toList(),
            ),
            SizedBox(height: 20),
            ExpansionTileGroup(
              toggleType: ToggleType.expandAll,
              children: items.map((item) {
                return ExpansionTileItem(
                  title: Text(item),
                  subtitle: Text('Subtitle for $item'),
                  leading: Icon(Icons.folder),
                  trailing: Icon(Icons.arrow_drop_down),
                  children: [
                    ListTile(
                      title: Text('Child of $item'),
                    ),
                  ],
                );
              }).toList(),
            ),
            SizedBox(height: 20),
            ExpansionTileGroup(
              toggleType: ToggleType.collapseAll,
              children: items.map((item) {
                return ExpansionTileItem(
                  title: Text(item),
                  subtitle: Text('Subtitle for $item'),
                  leading: Icon(Icons.folder),
                  trailing: Icon(Icons.arrow_drop_down),
                  children: [
                    ListTile(
                      title: Text('Child of $item'),
                    ),
                  ],
                );
              }).toList(),
            ),
          ],
        ),
      ),
    );
  }
}

文档与支持

• 官方文档
• 常见问题解答
• 贡献指南

如果您有任何问题或需要进一步的帮助，请参考官方文档或访问 GitHub 仓库提交 issue。希望这个插件能帮助您更好地构建复杂的可扩展列表项组！