Flutter实用工具集插件flutter_handy_utils的使用

flutter_handy_utils 是一个由社区驱动的项目，旨在简化Flutter开发中的常见任务。它提供了广泛的实用函数、扩展和小部件，使构建Flutter应用变得简单。以下是关于如何使用、贡献以及参与此包的所有信息。

特性

工具（Utils）

• TreeBuilder：用于创建结构化的父子关系。

扩展（Extensions）

• WidgetsSeparator：在列表中的小部件之间添加间隙或分隔符。
• StringEllipsSize：返回从开头或结尾截断到指定最大长度的新字符串。

小部件（Widgets）

• GroupedRadioButton：显示一组单选按钮的小部件。

使用方法

TreeBuilder 的使用

创建结构化的父子关系

1. 创建一个 TreeInputItem 列表：

final list = [
   TreeInputItem<int>(id: 1, parentId: 0, data: "Parent 1"),
   TreeInputItem<int>(id: 2, parentId: 1, data: "Child 1"),
   TreeInputItem<int>(id: 3, parentId: 1, data: "Child 2"),
];

1. 创建 TreeBuilder 实例：

final treeBuilder = TreeBuilder<int>();

1. 构建树结构：

final result = treeBuilder.buildTree(list);

结果将是一个包含父项及其子项的 List<TreeOutPutItem<int>>。

WidgetsSeparator 的使用

在小部件之间添加间隙或分隔符

• 使用 withDividerInBetween 添加分隔线：

listOfWidgets.withDividerInBetween(
     color: Colors.red,
     height: 20,
     thickness: 20,
     indent: 20,
     endIndent: 20,
);

• 使用 withGapInBetween 添加间隙：

listOfWidgets.withGapInBetween(gapSize: 20);

StringEllipsSize 的使用

截断字符串至指定长度

String text = "This is a very long string";

String truncatedText = text.ellipsSize(maxLength: 10);
print(truncatedText); // 输出："This is a..."

String truncatedTextFromStart = text.ellipsSize(maxLength: 10, fromStart: true);
print(truncatedTextFromStart); // 输出："...long string"

GroupedRadioButton 的使用

显示一组单选按钮

GroupedRadioButton<String>(
  items: [
    GroupedRadioButtonItem(title: Text("选项 1"), value: "option1"),
    GroupedRadioButtonItem(title: Text("选项 2"), value: "option2"),
  ],
  onChanged: (value) {
    print(value);
  },
  initialGroupValue: "option1",
),

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用 flutter_handy_utils 提供的功能：

import 'package:example/examples/grouped_radio_button_example.dart';
import 'package:flutter/material.dart';

import 'examples/string_ellips_size_example.dart';
import 'examples/tree_builder_example.dart';
import 'examples/widget_separator_example.dart';

void main() {
  runApp(const MainApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text("flutter_handy_utils 示例"),
          shadowColor: Colors.black,
          elevation: 5,
          scrolledUnderElevation: 0,
          surfaceTintColor: Colors.white,
          backgroundColor: Colors.white,
          centerTitle: true,
        ),
        body: Column(
          children: [
            _treeBuilder(),
            _widgetsSeparator(),
            _stringEllipsSize(),
            _groupedRadioButton(),
          ],
        ),
      ),
    );
  }

  ExpansionTile _widgetsSeparator() {
    return const ExpansionTile(
      title: Text("WidgetsSeparator"),
      childrenPadding: EdgeInsets.all(10),
      children: [
        WidgetsSeparatorExample(),
      ],
    );
  }

  ExpansionTile _treeBuilder() {
    return const ExpansionTile(
      title: Text("TreeBuilder"),
      childrenPadding: EdgeInsets.all(10),
      children: [
        TreeBuilderExample(),
      ],
    );
  }

  Widget _stringEllipsSize() {
    return const ExpansionTile(
      title: Text("StringEllipsSize"),
      childrenPadding: EdgeInsets.all(10),
      children: [
        StringEllipsSizeExample(),
      ],
    );
  }

  Widget _groupedRadioButton() {
    return const ExpansionTile(
      title: Text("GroupedRadioButton"),
      childrenPadding: EdgeInsets.all(10),
      children: [
        GroupedRadioButtonExample(),
      ],
    );
  }
}