Flutter功能扩展插件hz_kit的使用

一些常用的工具集合，可能包括一些算法、函数或小组件等。

开始使用

在 pubspec.yaml 文件中添加依赖：

dependencies:
  hz_kit: ^0.0.1

然后在终端执行 flutter pub get。

在需要使用的地方导入：

import 'package:hz_kit/hz_kit.dart';

使用方法

debounce（防抖）

debounce 函数确保某个函数在指定时间内不会被多次调用，只会执行最后一次调用。

debounce(
  () {
    print('function fired'); // 输出 "function fired"
  },
  time: const Duration(milliseconds: 600), // 等待 600 毫秒
  onCancel: () {
    print('Click canceled'); // 如果取消，则输出 "Click canceled"
  },
);

throttle（节流）

throttle 函数确保某个函数在指定时间内只能被调用一次。如果在等待时间内再次调用，则会忽略该调用。

throttle(
  () {
    print('function fired'); // 输出 "function fired"
  },
  time: const Duration(seconds: 2), // 等待 2 秒
  onIgnored: () {
    print('ignored'); // 如果被忽略，则输出 "ignored"
  },
  onLocked: () {
    print('locked'); // 在等待时间内输出 "locked"
  },
  onUnlocked: () => print('unlocked'), // 等待时间结束后输出 "unlocked"
);

throttleFuture（异步节流）

throttleFuture 函数用于处理异步函数的节流，确保在函数执行期间不接受新的调用。

throttleFuture(
  () async {
    print('function fired'); // 输出 "function fired"
    await Future.delayed(const Duration(seconds: 2)); // 等待 2 秒
    print('function done'); // 输出 "function done"
  },
  onIgnored: () {
    print('ignored'); // 如果被忽略，则输出 "ignored"
  },
  onLocked: () {
    print('locked'); // 在等待时间内输出 "locked"
  },
  onUnlocked: () => print('unlocked'), // 等待时间结束后输出 "unlocked"
);

完整示例代码

以下是一个完整的示例代码，展示了如何在应用中使用 hz_kit 插件。

import 'package:example/pages/homepage.dart'; // 引入页面
import 'package:flutter/material.dart'; // 引入 Flutter Material 库

void main() {
  runApp(const MyApp()); // 运行应用
}

class MyApp extends StatelessWidget {
  const MyApp({super.key}); // 构造函数

  // 这个小部件是你的应用的根
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo', // 应用标题
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.green), // 颜色方案
        useMaterial3: true, // 使用 Material 3 设计
      ),
      home: const Homepage(), // 主页
    );
  }
}