Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fluttercandies/flutter_smart_dialog
An elegant Flutter Dialog solution | 一种更优雅的 Flutter Dialog 解决方案
https://github.com/fluttercandies/flutter_smart_dialog
Last synced: 9 days ago
JSON representation
An elegant Flutter Dialog solution | 一种更优雅的 Flutter Dialog 解决方案
- Host: GitHub
- URL: https://github.com/fluttercandies/flutter_smart_dialog
- Owner: fluttercandies
- License: mit
- Created: 2020-11-30T13:58:55.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-16T14:05:23.000Z (about 2 months ago)
- Last Synced: 2024-09-17T14:19:20.953Z (about 2 months ago)
- Language: Dart
- Homepage:
- Size: 6.31 MB
- Stars: 1,101
- Watchers: 50
- Forks: 138
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- my-awesome-list - flutter_smart_dialog
README
[](https://pub.dev/packages/flutter_smart_dialog/install) [](https://github.com/fluttercandies/flutter_smart_dialog) [](https://github.com/fluttercandies/flutter_smart_dialog/issues) [](https://github.com/fluttercandies/flutter_smart_dialog/commits)
Feature and Usage（Must read！）：[super detailed guide](https://xdd666t.github.io/flutter_use/web/index.html#/smartDialog)
功能和用法（必看！）： [超详细指南](https://xdd666t.github.io/flutter_use/web/index.html#/smartDialog)
***
Language: English | [中文](https://juejin.cn/post/7026150456673959943)
Migrate doc：[3.x migrate 4.0](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/3.x%20migrate%204.0.md) | [3.x 迁移 4.0](https://juejin.cn/post/7093867453012246565)
Flutter 2：Please use `flutter_smart_dialog: 4.2.5`
# Introduction
An elegant Flutter Dialog solution.
# Some Effect
# Advantage
- **Do not need BuildContext**
- **Can penetrate dark background, click on the page behind dialog**
- **Support dialog stack，close the specified dialog**
- **Support positioning widget, display the specified location dialog**
- **Support highlight feature，dissolve the specified location mask**
- **Easily implement toast，loading，attach dialog，custome dialog**
# Quick start
## Install
- **latest version：[install pub](https://pub.flutter-io.cn/packages/flutter_smart_dialog/install)**
## Initialization
> **initialization**
```dart
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: HomePage,
// here
navigatorObservers: [FlutterSmartDialog.observer],
// here
builder: FlutterSmartDialog.init(),
);
}
}
```
> **Advanced initialization: configure global custom Loading and Toast**
SmartDialog's showLoading and showToast provide a default style. Of course, custom param are definitely supported.
- SmartDialog custom Loading or Toast is very simple: However, when using it, it may make you feel a little troublesome
- for example
- Use custom Loading: `SmartDialog.showLoading(builder: (_) => CustomLoadingWidget);`
- The effect we want must be like this: `SmartDialog.showLoading();`
- In view of the above considerations, I added the function of setting custom default Loading and Toast styles at the entrance
Let me show you the following
- The entry needs to be configured: implement toastBuilder and loadingBuilder, and pass in custom Toast and Loading
````dart
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: HomePage(),
// here
navigatorObservers: [FlutterSmartDialog.observer],
// here
builder: FlutterSmartDialog.init(
//default toast widget
toastBuilder: (String msg) => CustomToastWidget(msg: msg),
//default loading widget
loadingBuilder: (String msg) => CustomLoadingWidget(msg: msg),
),
);
}
}
````
## Easy usage
- **toast usage**💬
```dart
SmartDialog.showToast('test toast');
```
- **loading usage**⏳
```dart
SmartDialog.showLoading();
await Future.delayed(Duration(seconds: 2));
SmartDialog.dismiss();
```
- **dialog usage**🎨
```dart
SmartDialog.show(builder: (context) {
return Container(
height: 80,
width: 180,
decoration: BoxDecoration(
color: Colors.black,
borderRadius: BorderRadius.circular(10),
),
alignment: Alignment.center,
child:
Text('easy custom dialog', style: TextStyle(color: Colors.white)),
);
});
```
# You may have questions
For details, please check： [Some Consideration Details](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/Some%20Consideration.md)
# Attach Chapter
For details, please check： [Attach Chapter Details](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/Attach%20Chapter.md)
This is a very important function. I wanted to add it a long time ago, but it was busy and has been shelved; New Year's Day (2022.1.1) started, and it took some time to complete this function and related demos.
# Dialog Chapter
For details, please check： [Dialog Chapter Details](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/Dialog%20Chapter.md)
# Loading Chapter
For details, please check： [Loading Chapter Details](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/Loading%20Chapter.md)
# Toast Chapter
For details, please check： [Toast Chapter Details](https://github.com/fluttercandies/flutter_smart_dialog/blob/master/docs/Toast%20Chapter.md)
