Flutter功能扩展插件eyf_kit的使用

在本篇文章中，我们将详细介绍如何使用 eyf_kit 插件，该插件提供了丰富的功能扩展，包括事件处理、系统方法、工具类以及各种类型的扩展。以下是详细的使用说明及示例代码。

1、事件

1.1 事件快速点击处理

通过 ClickEvent.isFastClick() 方法可以快速检测是否为连续快速点击，避免重复触发事件。

void onEvent() {
  if (ClickEvent.isFastClick()) {
    return;
  }
  // 这里处理你的业务逻辑...
}

2、系统方法

2.1 剪贴板使用

eyf_kit 提供了方便的剪贴板操作工具类 ClipboardUtils，用于获取和设置剪贴板数据。

// 获取剪贴板数据
ClipboardUtils.getClipboardData().then((text) => {
  // text 剪贴板内容
});

// 或者使用异步方式
var text = await ClipboardUtils.getClipboardData();

// 设置剪贴板数据
ClipboardUtils.setClipboardData("Hello, world!");

3、常用工具类

3.1 JSON 工具类

JsonUtils 提供了多种 JSON 数据处理方法，例如将对象转换为 JSON 字符串、从 JSON 字符串解析为 Map 或 List 等。

// 将对象转换为 JSON 字符串
String jsonString = JsonUtils.toJson({"name": "China", "date": "2024"});

// 从 JSON 字符串转换为 Map 对象
Map<String, dynamic> map = JsonUtils.fromJson('{"name":"china","date":"2024"}');

// 从 JSON 字符串转换为 List 列表
List list = JsonUtils.fromList('[1, 2, 3]');

// 获取 JSON 中的某个属性值
var value = JsonUtils.getValue(keyName: "name", json: '{"name":"china","date":"2024"}'); // 输出 "china"

3.2 软键盘工具类

SoftUtils 提供隐藏软键盘的方法。

// 隐藏软键盘
SoftUtils.hideSoft(context);

3.3 倒计时工具类

CountdownTimer 可以实现基于时间的倒计时功能。

var countdown = CountdownTimer();

// 根据剩余时间倒计时
countdown.startCountdown(10000, (remainingTime) {
  print("剩余时间: $remainingTime 毫秒");
}, step: 1000);

// 停止倒计时
countdown.stop();

// 获取剩余时间差
print(countdown.diffTime);

3.4 按天、小时、分、秒计时器

TimingCount 可以按天、小时、分、秒进行计时。

var timing = TimingCount();

// 开始计时
timing.start((days, hours, minutes, seconds) {
  print("$days 天 $hours 小时 $minutes 分 $seconds 秒");
}, step: 1000);

// 停止计时
timing.stop();

// 获取计时持续时间
print(timing.duration);

4、扩展

4.1 dynamic 扩展

dynamic 类型支持一些实用的扩展方法。

var result = "false";
var status = result.isTrue; // 输出 true 或 false

enum Gender { male, female }
Gender.female.name; // 输出枚举名称 "female"

var num = "111";
var digit = num.isNumeric; // 判断是否为数字类型，输出 true 或 false

4.2 Object 扩展

Object 类型也支持一些实用的扩展方法。

var result = "11";
result.toDouble(); // 输出 11.0

4.3 String 扩展

String 类型提供了许多实用的扩展方法。

var uri = "xxxx?name=11&age=2";
uri.toMap("&", secondSplit: "=", true); // 输出 {"name": "11", "age": "2"}

"2&71&3&25".toList("&"); // 输出 ["2", "71", "3", "25"]

var uri2 = "xxxx?name2=22";
uri2.toMergeUrl(uri); // 输出 "xxxx?name=11&age=2&name2=22"

"20.3".toFormatString("#.##"); // 输出 "20.30"

"123456".toSha1; // 输出 "7c4a8d09ca3762af61e59520943dc26494f8941b"

"123456".toSha256; // 输出 "8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92"

"123456".generateMd5; // 输出 "e10adc3949ba59abbe56e057f20f883e"

4.4 double 扩展

double 类型支持一些实用的扩展方法。

var n = 12.3;
n.doubleInt; // 输出 12

n.isNullOrZero; // 输出 false

n.reduce(3); // 输出 9.3

n.add(3); // 输出 15.3

n.toFormatString("#.##"); // 输出 "12.30"

4.5 int 扩展

int 类型也支持一些实用的扩展方法。

var n = 12;

n.isNullOrZero; // 输出 false

n.reduce(3); // 输出 9

n.add(3); // 输出 15

var timestamp = DateTime.now().millisecondsSinceEpoch;
timestamp.toLocalTime(isUtc: true); // 输出 DateTime 格式的时间

示例代码

以下是一个完整的示例代码，展示如何集成并使用 eyf_kit 插件。

// example/lib/main.dart
import 'package:flutter/material.dart';
import 'package:eyf_kit/eyf_kit.dart'; // 引入 eyf_kit 插件

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('eyf_kit 示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () {
                  // 使用 ClickEvent 快速点击检测
                  if (ClickEvent.isFastClick()) {
                    print("快速点击检测到！");
                    return;
                  }
                  print("业务逻辑执行！");
                },
                child: const Text("快速点击检测"),
              ),
              ElevatedButton(
                onPressed: () async {
                  // 使用 ClipboardUtils 操作剪贴板
                  var text = await ClipboardUtils.getClipboardData();
                  print("剪贴板内容: $text");
                  ClipboardUtils.setClipboardData("复制成功！");
                },
                child: const Text("剪贴板操作"),
              ),
              ElevatedButton(
                onPressed: () {
                  // 使用 JsonUtils 解析 JSON 数据
                  var map = JsonUtils.fromJson('{"name":"China","date":"2024"}');
                  print("JSON 解析结果: $map");
                },
                child: const Text("JSON 解析"),
              ),
            ],
          ),
        ),
      ),
    );
  }
}