tolyui_feedback_modal 0.0.1

A powerful Flutter bottom sheet picker with async task support, status monitoring, timeout cancellation and theme customization.

TolyUI Feedback Modal

一个功能强大的 Flutter 底部弹窗选择器，支持异步任务、状态监听、超时取消和主题自定义。

功能特性

• ✅ 异步任务支持 - 支持异步操作和状态回调
• ✅ 超时取消机制 - 任务超时自动取消，避免资源浪费
• ✅ 状态监听 - 实时监听加载、成功、失败、超时状态
• ✅ 主题自定义 - 支持亮色/暗色主题，可自定义所有样式
• ✅ 灵活配置 - 支持标题、消息、取消按钮等多种配置
• ✅ 类型安全 - 完整的泛型支持

安装

在 pubspec.yaml 中添加依赖：

dependencies:
  tolyui_feedback_modal: ^1.0.0

基础用法

简单选择器

showTolyPopPicker(
  context: context,
  title: Text('选择操作'),
  tasks: [
    TolyMenuItem(
      info: '编辑',
      task: () => print('编辑'),
    ),
    TolyMenuItem(
      info: '删除', 
      task: () => print('删除'),
    ),
  ],
);

异步任务

showTolyPopPicker<String>(
  context: context,
  title: Text('网络操作'),
  tasks: [
    TolyMenuItem<String>(
      info: '上传文件',
      task: () async {
        await Future.delayed(Duration(seconds: 2));
        return '上传成功';
      },
    ),
  ],
);

状态监听

showTolyPopPicker(
  context: context,
  tasks: [...],
  onStatusChange: (status) {
    if (status is Loading) {
      print('加载中...');
    } else if (status is Success) {
      print('成功: ${status.data}');
    } else if (status is Failure) {
      print('失败: ${status.error}');
    } else if (status is Timeout) {
      print('超时');
    }
  },
);

主题自定义

使用预设主题

// 亮色主题
MaterialApp(
  theme: ThemeData(
    extensions: [TolyPopPickerTheme.light()],
  ),
);

// 暗色主题
MaterialApp(
  theme: ThemeData(
    extensions: [TolyPopPickerTheme.dark()],
  ),
);

自定义主题

showTolyPopPicker(
  context: context,
  theme: TolyPopPickerTheme(
    backgroundColor: Colors.blue,
    borderRadius: 20.0,
    itemHeight: 60.0,
    itemTextStyle: TextStyle(
      fontSize: 18,
      color: Colors.white,
    ),
  ),
  tasks: [...],
);

超时控制

任务默认 5 秒超时，超时后自动取消：

TolyMenuItem(
  info: '长时间任务',
  task: () async {
    // 这个任务如果超过 5 秒会被自动取消
    await Future.delayed(Duration(seconds: 10));
    return '完成';
  },
);

API 参考

showTolyPopPicker 参数

参数	类型	描述
context	BuildContext	上下文
tasks	List<TolyMenuItem	任务列表
title	Widget?	标题
message	String?	消息文本
theme	TolyPopPickerTheme?	自定义主题
cancelText	String	取消按钮文本
onStatusChange	OnStateChange	状态变化回调

TolyMenuItem 参数

参数	类型	描述
info	String	显示文本
task	Task	异步任务
content	Widget?	自定义内容
loadingBuilder	WidgetBuilder?	加载状态构建器

许可证

MIT License