Flutter QuickDialog #

A lightweight Dialog library for Flutter, which is implemented purely in Flutter and enables you to easily call the Dialog and loading functions without the need for context.

Installation #

Add the following code to the pubspec.yaml file in your project:

dependencies:
  quick_dialog: ^latest

Import #

import 'package:quick_dialog/quick_dialog.dart';

QuickDialog Flutter 插件 #

一个轻量高效的Flutter对话框解决方案，提供丰富的自定义配置和流畅的动画效果。

🌟 功能特性 #

• 多主题支持：内置浅色/深色双主题
• 多种对话框类型：
  • 模态对话框（Modal）
  • 半屏对话框（Half Screen）
  • 自定义组件对话框（Widget）
• 灵活动画系统：
  • 支持透明度/位移/缩放动画
  • 可扩展自定义动画
• 智能布局：
  • 顶部/居中/底部定位
  • 按钮水平/垂直排列
• 可定制样式：
  • 圆角半径
  • 边距/内边距
  • 文本样式覆盖
  • 自定义遮罩颜色

📦 安装 #

在 pubspec.yaml 中添加：

dependencies:
  quick_dialog: ^latest_version

🚀 快速开始 #

1. 初始化 #

void main() {
  runApp(MaterialApp(
    builder: QuickDialog.init(),
    home: MyApp(),
  ));
}

2. 基本使用 #

// 显示模态对话框
QuickDialog.showModal(
  title: "系统提示",
  content: "确认要删除这条数据吗？",
  confirmText: "确认删除",
  cancelText: "取消操作",
  confirmCallback: () => print("确认操作"),
  cancelCallback: () => print("取消操作"),
);

// 显示自定义对话框
QuickDialog.showDialog(
  child: MyCustomWidget(),
  maskType: QuickDialogMaskType.black,
  animation: QuickDialogAnimationStyle.scale,
);

// 关闭对话框
QuickDialog.dismiss();

⚙️ 参数说明 #

showModal 方法参数说明 #

动画类型枚举 #

enum QuickDialogAnimationStyle {
  opacity,    // 透明度动画
  offset,     // 位移动画
  scale,      // 缩放动画
  custom      // 自定义动画
}

遮罩类型枚举 #

enum QuickDialogMaskType {
  none,       // 无遮罩
  clear,      // 透明遮罩
  black,      // 黑色半透明遮罩
  custom      // 自定义遮罩
}

🎨 自定义样式 #

// 修改全局配置
QuickDialog.instance
  ..style = QuickDialogStyle.dark
  ..radius = BorderRadius.circular(20)
  ..animationDuration = Duration(milliseconds: 300)
  ..margin = EdgeInsets.symmetric(vertical: 50);

// 自定义按钮样式
QuickDialog.showModal(
  confirmTextStyle: TextStyle(
    color: Colors.red,
    fontWeight: FontWeight.bold
  ),
  cancelTextStyle: TextStyle(
    color: Colors.grey,
    decoration: TextDecoration.underline
  ),
);

⚠️ 注意事项 #

1. 必须初始化：在 MaterialApp 中调用 QuickDialog.init()

Open Source License #

MIT License

❤️❤️❤️ #

Thanks to JetBrains Open Source for support