增加了不少實用的功能，最新更新介紹肥缔，請查看：https://juejin.cn/post/7026150456673959943

前言

Q：你一生中聞過最臭的東西莲兢，是什么？

A：我那早已腐爛的夢续膳。

兄弟萌８耐А！姑宽！我又來了遣耍！

這次，我能自信的對大家說：我終于給大家?guī)Я艘粋€炮车，能真正幫助大家解決諸多坑比場景的pub包！

將之前的flutter_smart_dialog酣溃，在保持api穩(wěn)定的基礎(chǔ)上瘦穆，進(jìn)行了各種抓頭重構(gòu)，解決了一系列問題

現(xiàn)在赊豌，我終于可以說：它現(xiàn)在是一個簡潔扛或，強(qiáng)大，侵入性極低的pub包碘饼！

關(guān)于侵入性問題

• 之前為了解決返回關(guān)閉彈窗熙兔，使用了一個很不優(yōu)雅的解決方法，導(dǎo)致侵入性有點高
• 這真是讓我如坐針氈艾恼，如芒刺背住涉，如鯁在喉，這個問題終于搞定了钠绍！

同時舆声，我在pub包內(nèi)部設(shè)計了一個彈窗棧，能自動移除棧頂彈窗，也可以定點移除棧內(nèi)標(biāo)記的彈窗媳握。

存在的問題

使用系統(tǒng)彈窗存在一系列坑碱屁，來和各位探討探討

• 必須傳BuildContext

  • 在一些場景必須多做一些傳參工作，蛋痛但不難的問題

• loading彈窗

  • 使用系統(tǒng)彈窗做loading彈窗蛾找，肯定遇到過這個坑比問題
    • loading封裝在網(wǎng)絡(luò)庫里面：請求網(wǎng)絡(luò)時加載loading娩脾，手賤按了返回按鈕，關(guān)閉了loading
    • 然后請求結(jié)束后發(fā)現(xiàn)：特么我的頁面怎么被關(guān)了４蛎Ｊ辽蕖！
  • 系統(tǒng)彈窗就是一個路由頁面隘冲，關(guān)閉系統(tǒng)就是用pop方法闹瞧，這很容易誤關(guān)正常頁面
    • 當(dāng)然肯定有解決辦法，路由監(jiān)聽的地方處理展辞，此處就不細(xì)表了

• 某頁面彈出了多個系統(tǒng)Dialog奥邮，很難定點關(guān)閉某個非棧頂彈窗

  • 蛋蛋，這是路由入棧出棧機(jī)制導(dǎo)致的罗珍，理解的同時也一樣要吐槽

• 系統(tǒng)Dialog洽腺，點擊事件無法穿透暗色背景

  • 這個坑比問題，我是真沒轍

相關(guān)思考

上面列舉了一些比較常見的問題覆旱，最嚴(yán)重的問題蘸朋，應(yīng)該就是loading的問題

• loading是個超高頻使用的彈窗，關(guān)閉loading彈窗的方法扣唱，同時也能關(guān)閉正常使用的頁面藕坯，本身就是一個隱患

• 穿透dialog遮罩是個非常重要的功能，基于該功能噪沙，能夠在實際業(yè)務(wù)中炼彪，實現(xiàn)很多騷操作

• 既然在系統(tǒng)dialog難以解決各種痛點，加上系統(tǒng)dialog也是基于overlay去實現(xiàn)的正歼，這樣的話辐马，我們也可以去高度定制overlay！

這次局义，我要一次性幫各位解決：toast消息喜爷，loading彈窗，以及更強(qiáng)大的自定義dialog萄唇！

快速上手

初始化

• 引入（最新版本請點擊pub查看）：pub檩帐，github，web effect

dependencies:
  flutter_smart_dialog: ^3.2.0

• 接入方式更加簡潔??

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(),
    );
  }
}

極簡使用

• toast使用??

SmartDialog.showToast('test toast');

[圖片上傳失敗...(image-f31b20-1641222341623)]

• loading使用?

SmartDialog.showLoading();
await Future.delayed(Duration(seconds: 2));
SmartDialog.dismiss(); 

[圖片上傳失敗...(image-66991d-1641222341623)]

• dialog使用??

var custom = Container(
    height: 80,
    width: 180,
    decoration: BoxDecoration(
        color: Colors.black,
        borderRadius: BorderRadius.circular(20),
    ),
    alignment: Alignment.center,
    child: Text('easy custom dialog', style: TextStyle(color: Colors.white)),
);
// here
SmartDialog.show(widget: custom, isLoadingTemp: false);

[圖片上傳失敗...(image-34c4d7-1641222341623)]

OK穷绵，上面展示了轿塔，只需要極少的代碼，就可以調(diào)用相應(yīng)的功能

當(dāng)然，內(nèi)部還有不少地方做了特殊優(yōu)化勾缭，接下來揍障，我會詳細(xì)的向大家描述下

你可能會有的疑問

初始化框架的時候，相比以前俩由，居然讓大家多寫了一個參數(shù)毒嫡，內(nèi)心十分愧疚??

關(guān)閉頁面本質(zhì)上是一個比較復(fù)雜的情況，涉及到

• 物理返回按鍵
• AppBar的back按鈕
• 手動pop

為了監(jiān)控這些情況幻梯，不得已增加了一個路由監(jiān)控參數(shù)

實體返回鍵

對返回按鈕的監(jiān)控兜畸，是非常重要的，基本能覆蓋大多數(shù)情況

initBack

pop路由

雖然對返回按鈕的監(jiān)控能覆蓋大多數(shù)場景碘梢，但是一些手動pop的場景就需要新增參數(shù)監(jiān)控

• 不加FlutterSmartDialog.observer
  • 如果打開了穿透參數(shù)（就可以和彈窗后的頁面交互）咬摇，然后手動關(guān)閉頁面
  • 就會出現(xiàn)這種很尷尬的情況

initPopOne

• 加了FlutterSmartDialog.observer，就能比較合理的處理了
  • 當(dāng)然煞躬，這里的過渡動畫肛鹏，也提供了參數(shù)控制是否開啟 ??

[圖片上傳失敗...(image-1b78e7-1641222341623)]

關(guān)于 FlutterSmartDialog.init()

本方法不會占用你的builder參數(shù)，init內(nèi)部回調(diào)出來了builder恩沛，你可以大膽放心的繼續(xù)套

• 例如：繼續(xù)套Bloc全局實例??

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage,
      navigatorObservers: [FlutterSmartDialog.observer],
      builder: FlutterSmartDialog.init(builder: _builder),
    );
  }
}

Widget _builder(BuildContext context, Widget? child) {
  return MultiBlocProvider(
    providers: [
      BlocProvider.value(value: BlocSpanOneCubit()),
    ],
    child: child!,
  );
}

超實用的參數(shù)：backDismiss

• 這個參數(shù)是默認(rèn)設(shè)置為true在扰，返回的時候會默認(rèn)關(guān)閉彈窗；如果設(shè)置為false雷客，將不會關(guān)閉頁面
  • 這樣就可以十分輕松的做一個緊急彈窗芒珠，禁止用戶的下一步操作
• 我們來看一個場景：假定某開源作者決定棄坑軟件，不允許用戶再使用該軟件的彈窗

SmartDialog.show(
  // here
  backDismiss: false,
  clickBgDismissTemp: false,
  isLoadingTemp: false,
  widget: Container(
    height: 480,
    width: 500,
    padding: EdgeInsets.all(20),
    decoration: BoxDecoration(
      borderRadius: BorderRadius.circular(20),
      color: Colors.white,
    ),
    alignment: Alignment.topCenter,
    child: SingleChildScrollView(
      child: Wrap(
        direction: Axis.vertical,
        crossAxisAlignment: WrapCrossAlignment.center,
        spacing: 10,
        children: [
          // title
          Text(
            '特大公告',
            style: TextStyle(fontSize: 30, fontWeight: FontWeight.bold),
          ),
          // content
          Text('鄙人日夜鉆研下面秘籍搅裙，終于成功釣到富婆'),
          Image.network(
            'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211102213746.jpeg',
            height: 200,
            width: 400,
          ),
          Text('鄙人思考了三秒鐘皱卓，懷著\'沉重\'的心情，決定棄坑本開源軟件'),
          Text('本人今后的生活是富婆和遠(yuǎn)方部逮，已無\'精力\' 再維護(hù)本開源軟件了'),
          Text('各位叼毛好爬，有緣江湖再見！'),
          // button (only method of close the dialog)
          ElevatedButton(
            onPressed: () => SmartDialog.dismiss(),
            child: Text('再會甥啄！'),
          )
        ],
      ),
    ),
  ),
);

hardClose

從上面的效果圖可以看出來

• 點擊遮罩，無法關(guān)閉彈窗
• 點擊返回按鈕無法關(guān)閉彈窗
• 只能點我們自己的按鈕炬搭，才能關(guān)閉彈窗蜈漓，點擊按鈕的邏輯可以直接寫成關(guān)閉app之類

只需要倆個簡單的參數(shù)設(shè)置，就能實現(xiàn)這樣一個很棒的應(yīng)急彈窗

設(shè)置全局參數(shù)

SmartDialog的全局參數(shù)都有著一個比較合理的默認(rèn)值

為了應(yīng)付多變的場景宫盔，你可以修改符合你自己要求的全局參數(shù)

• 設(shè)置符合你的要求的數(shù)據(jù)融虽，放在app入口就行初始化就行
  • 注：如果沒有特殊要求，可以不用初始化全局參數(shù)（內(nèi)部皆有默認(rèn)值）

SmartDialog.config
  ..alignment = Alignment.center
  ..isPenetrate = false
  ..clickBgDismiss = true
  ..maskColor = Colors.black.withOpacity(0.35)
  ..maskWidget = null
  ..animationDuration = Duration(milliseconds: 260)
  ..isUseAnimation = true
  ..isLoading = true
  ..debounce = false
  ..debounceTime = Duration(milliseconds: 300);

• 代碼的注釋寫的很完善灼芭，某個參數(shù)不明白的有额，點進(jìn)去看看就行了

image-20211102223129866

Attach篇

這是一個很重要的功能，本來早就想加進(jìn)去了，但是比較忙巍佑，一直擱置了茴迁；元旦（2022.1.1）開了頭，就花了一些時間萤衰，完成了這個功能和相關(guān)demo

定位

定位目標(biāo)widget的坐標(biāo)堕义，這個做起來并不難；但是必須要拿到我們傳入的自定義widget大小脆栋，這樣才能將自定義widget疊放到一個比較合適的位置（通過一些計算倦卖，獲取中心點）

• 實際上Flutter提供一個非常合適的組件CustomSingleChildLayout，這個組件還提供偏移坐標(biāo)功能椿争，按理來說非常合適
• 但是怕膛，CustomSingleChildLayout 和 SizeTransition 動畫控件，存在占位面積沖突秦踪，只能使用AnimatedOpacity漸隱動畫
• 位移動畫不能用褐捻，這我沒法忍，拋棄 CustomSingleChildLayout洋侨；使用了各種騷操作舍扰，終于拿到自定義widget的大小，比較完美實現(xiàn)了效果

定位dialog希坚，使用showAttach方法边苹，參數(shù)注釋寫的相當(dāng)詳細(xì)，不明白用法的看看注釋就行了

強(qiáng)大的定位功能

• 必須傳目標(biāo)widget的BuildContext裁僧，需要通過它計算出目標(biāo)widget的坐標(biāo)和大小

var attach = (BuildContext context, AlignmentGeometry alignment) async {
  SmartDialog.showAttach(
    targetContext: context,
    isPenetrateTemp: true,
    alignmentTemp: alignment,
    clickBgDismissTemp: false,
    widget: Container(width: 100, height: 100, color: randomColor()),
  );
  await Future.delayed(Duration(milliseconds: 350));
};

//target widget
List<BuildContext> contextList = [];
List<Future Function()> funList = [
  () async => await attach(contextList[0], Alignment.topLeft),
  () async => await attach(contextList[1], Alignment.topCenter),
  () async => await attach(contextList[2], Alignment.topRight),
  () async => await attach(contextList[3], Alignment.centerLeft),
  () async => await attach(contextList[4], Alignment.center),
  () async => await attach(contextList[5], Alignment.centerRight),
  () async => await attach(contextList[6], Alignment.bottomLeft),
  () async => await attach(contextList[7], Alignment.bottomCenter),
  () async => await attach(contextList[8], Alignment.bottomRight),
];
var btn = ({
  required String title,
  required Function(BuildContext context) onTap,
}) {
  return Builder(builder: (context) {
    Color? color = title.contains('all') ? randomColor() : null;
    contextList.add(context);
    return Container(
      width: 130,
      child: ElevatedButton(
        style: ButtonStyle(
          backgroundColor: ButtonStyleButton.allOrNull<Color>(color),
        ),
        onPressed: () => onTap(context),
        child: Text('$title'),
      ),
    );
  });
};

SmartDialog.show(
  isLoadingTemp: false,
  widget: Container(
    width: 700,
    padding: EdgeInsets.all(70),
    decoration: BoxDecoration(
      borderRadius: BorderRadius.circular(20),
      color: Colors.white,
    ),
    child: Wrap(
      spacing: 50,
      runSpacing: 50,
      alignment: WrapAlignment.spaceEvenly,
      children: [
        btn(title: 'topLeft', onTap: (context) => funList[0]()),
        btn(title: 'topCenter', onTap: (context) => funList[1]()),
        btn(title: 'topRight', onTap: (context) => funList[2]()),
        btn(title: 'centerLeft', onTap: (context) => funList[3]()),
        btn(title: 'center', onTap: (context) => funList[4]()),
        btn(title: 'centerRight', onTap: (context) => funList[5]()),
        btn(title: 'bottomLeft', onTap: (context) => funList[6]()),
        btn(title: 'bottomCenter', onTap: (context) => funList[7]()),
        btn(title: 'bottomRight', onTap: (context) => funList[8]()),
        btn(
          title: 'allOpen',
          onTap: (_) async {
            for (var item in funList) {
              await item();
            }
          },
        ),
        btn(
          title: 'allClose',
          onTap: (_) => SmartDialog.dismiss(status: SmartStatus.allAttach),
        ),
      ],
    ),
  ),
);

[圖片上傳失敗...(image-730d52-1641222341623)]

動畫效果和show方法幾乎是一致的个束，為了這個一致的體驗，內(nèi)部做了相當(dāng)多的針對性優(yōu)化

自定義坐標(biāo)點

• 大多數(shù)情況基本都是使用targetContext

SmartDialog.showAttach(
  targetContext: context,
  widget: Container(width: 100, height: 100, color: Colors.red),
);

• 當(dāng)然還有少數(shù)情況聊疲，需要使用自定義坐標(biāo)茬底，此處也提供target參數(shù)：設(shè)置了target參數(shù)，targetContext將自動失效
  • targetContext 是十分常見到場景获洲，所以阱表，這邊設(shè)置為必傳參數(shù)，但是你可以給它設(shè)置為null

SmartDialog.showAttach(
  targetContext: null,
  target: Offset(100, 100);,
  widget: Container(width: 100, height: 100, color: Colors.red),
);

• 看來下自定義坐標(biāo)點效果

var attach = (Offset offset) {
  var random = Random().nextInt(100) % 5;
  var alignment = Alignment.topCenter;
  if (random == 0) alignment = Alignment.topCenter;
  if (random == 1) alignment = Alignment.centerLeft;
  if (random == 2) alignment = Alignment.center;
  if (random == 3) alignment = Alignment.centerRight;
  if (random == 4) alignment = Alignment.bottomCenter;
  SmartDialog.showAttach(
    targetContext: null,
    target: offset,
    isPenetrateTemp: true,
    clickBgDismissTemp: false,
    alignmentTemp: alignment,
    keepSingle: true,
    widget: ClipRRect(
      borderRadius: BorderRadius.circular(10),
      child: Container(width: 100, height: 100, color: randomColor()),
    ),
  );
};

SmartDialog.show(
  isLoadingTemp: false,
  widget: Container(
    width: 600,
    height: 400,
    alignment: Alignment.center,
    decoration: BoxDecoration(
      borderRadius: BorderRadius.circular(20),
      color: Colors.white,
    ),
    child: GestureDetector(
      onTapDown: (detail) => attach(detail.globalPosition),
      child: Container(
        width: 500,
        height: 300,
        color: Colors.grey,
        alignment: Alignment.center,
        child: Text('click me', style: TextStyle(color: Colors.white)),
      ),
    ),
  ),
);

attachPoint

模仿DropdownButton

• 實際上模仿DropdownButton挺不容易的
  • 首先要計算DropdownButton控件的位置贡珊，在其位置上顯示點擊后的折疊控件
  • 需要處理DropdownButton之外區(qū)域的點擊事件（點擊區(qū)域外關(guān)閉DropdownButton）
  • 還需要監(jiān)聽返回事件最爬，手動pop路由事件；是這類事件的门岔，需要關(guān)閉DropdownButton
• 這玩意要自定義爱致，挺讓人頭大的；但是寒随，現(xiàn)在你可以使用SmartDialog.showAttach 輕松模仿一個糠悯，上述需要注意的事項都幫你處理好了

//模仿DropdownButton
var imitate = (BuildContext context) {
  var list = ['小呆呆', '小菲菲', '小豬豬'];
  SmartDialog.showAttach(
    targetContext: context,
    isPenetrateTemp: true,
    widget: Container(
      margin: EdgeInsets.all(10),
      decoration: BoxDecoration(
        boxShadow: [
          BoxShadow(color: Colors.black12, blurRadius: 8, spreadRadius: 0.2)
        ],
      ),
      child: Column(
        children: List.generate(list.length, (index) {
          return Material(
            color: Colors.white,
            child: InkWell(
              onTap: () => SmartDialog.dismiss(),
              child: Container(
                height: 50,
                width: 100,
                alignment: Alignment.center,
                child: Text('${list[index]}'),
              ),
            ),
          );
        }),
      ),
    ),
  );
};

//imitate widget
var dropdownButton = ({String title = 'Dropdown'}) {
  return DropdownButton<String>(
    value: '1',
    items: [
      DropdownMenuItem(value: '1', child: Text('$title：小呆呆')),
      DropdownMenuItem(value: '2', child: Text('小菲菲')),
      DropdownMenuItem(value: '3', child: Text('小豬豬'))
    ],
    onChanged: (value) {},
  );
};
var imitateDropdownButton = () {
  return Builder(builder: (context) {
    return Stack(children: [
      dropdownButton(title: 'Attach'),
      GestureDetector(
        onTap: () => imitate(context),
        child: Container(height: 50, width: 140, color: Colors.transparent),
      )
    ]);
  });
};
SmartDialog.show(
  isLoadingTemp: false,
  widget: Container(
    width: 600,
    height: 400,
    alignment: Alignment.center,
    padding: EdgeInsets.symmetric(horizontal: 100),
    decoration: BoxDecoration(
      borderRadius: BorderRadius.circular(20),
      color: Colors.white,
    ),
    child: MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Row(
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        children: [dropdownButton(), imitateDropdownButton()],
      ),
    ),
  ),
);

attachImitate

高亮

這次把遮罩特定區(qū)域高亮的功能加上了帮坚，這是一個非常實用的功能！

• 你只需要設(shè)置highlight參數(shù)即可
  • 定義高亮的區(qū)域互艾，他必須是個不通透的Widget试和，例如是Contaienr，必須設(shè)置一個顏色（色值無要求）
    • 使用各種奇形怪狀的圖片也行忘朝，這樣就能顯示各種復(fù)雜圖形的高亮區(qū)域
  • highlight類型是Positioned灰署，你可以在屏幕上定位任何需要高亮的區(qū)域

SmartDialog.showAttach(
  targetContext: context,
  alignmentTemp: Alignment.bottomCenter,
  highlight: Positioned(
    right: 190,
    bottom: 190,
    child: Container(
      height: 120,
      width: 120,
      decoration: BoxDecoration(
        borderRadius: BorderRadius.circular(10),
        color: Colors.white,
      ),
    ),
  ),
  widget: Container(width: 100, height: 100, color: Colors.red),
);

實際的業(yè)務(wù)場景

• 這邊舉倆個常見的例子，代碼有一點點多局嘁，就不貼了溉箕，感興趣的請查看：flutter_use

attachBusiness

上面?zhèn)z個業(yè)務(wù)場景非常常見，有時候悦昵，我們需要目標(biāo)widget上面或下面或特定的區(qū)域肴茄，不被遮罩覆蓋

自己去做的話，可以做出來但指，但是會很麻煩寡痰；現(xiàn)在你可以使用showAttach中的highlight參數(shù)輕松實現(xiàn)這個需求

引導(dǎo)操作

引導(dǎo)操作在app上還是非常常見的，需要指定區(qū)域高亮棋凳，然后介紹其功能

• 使用showAttach中的highlight參數(shù)拦坠，也可以輕松實現(xiàn)這個需求，來看下效果
  • 代碼同樣有一點點多剩岳，感興趣的請查看：flutter_use

[圖片上傳失敗...(image-df0879-1641222341623)]

Dialog篇

花里胡哨

彈窗從不同位置彈出贞滨，動畫是有區(qū)別的

image-20211031221419600

• alignmentTemp：該參數(shù)設(shè)置不同，動畫效果會有所區(qū)別

var location = ({
  double width = double.infinity,
  double height = double.infinity,
}) {
  return Container(width: width, height: height, color: randomColor());
};

//left
SmartDialog.show(
  widget: location(width: 70),
  alignmentTemp: Alignment.centerLeft,
);
await Future.delayed(Duration(milliseconds: 500));
//top
SmartDialog.show(
  widget: location(height: 70),
  alignmentTemp: Alignment.topCenter,
);
await Future.delayed(Duration(milliseconds: 500));
//right
SmartDialog.show(
  widget: location(width: 70),
  alignmentTemp: Alignment.centerRight,
);
await Future.delayed(Duration(milliseconds: 500));
//bottom
SmartDialog.show(
  widget: location(height: 70),
  alignmentTemp: Alignment.bottomCenter,
);
await Future.delayed(Duration(milliseconds: 500));
//center
SmartDialog.show(
  widget: location(height: 100, width: 100),
  alignmentTemp: Alignment.center,
  isLoadingTemp: false,
);

[圖片上傳失敗...(image-aa397e-1641222341623)]

• isPenetrateTemp：交互事件穿透遮罩

SmartDialog.show(
    alignmentTemp: Alignment.centerRight,
    isPenetrateTemp: true,
    clickBgDismissTemp: false,
    widget: Container(
        width: 80,
        height: double.infinity,
        color: randomColor(),
    ),
);

dialogPenetrate

dialog棧

• 這是一個強(qiáng)大且實用的功能拍棕！
  • 可以很輕松的定點關(guān)閉某個彈窗

var stack = ({
  double width = double.infinity,
  double height = double.infinity,
  String? msg,
}) {
  return Container(
    width: width,
    height: height,
    color: randomColor(),
    alignment: Alignment.center,
    child: Text('dialog $msg', style: TextStyle(color: Colors.white)),
  );
};

//left
SmartDialog.show(
  tag: 'A',
  widget: stack(msg: 'A', width: 70),
  alignmentTemp: Alignment.centerLeft,
);
await Future.delayed(Duration(milliseconds: 500));
//top
SmartDialog.show(
  tag: 'B',
  widget: stack(msg: 'B', height: 70),
  alignmentTemp: Alignment.topCenter,
);
await Future.delayed(Duration(milliseconds: 500));
//right
SmartDialog.show(
  tag: 'C',
  widget: stack(msg: 'C', width: 70),
  alignmentTemp: Alignment.centerRight,
);
await Future.delayed(Duration(milliseconds: 500));
//bottom
SmartDialog.show(
  tag: 'D',
  widget: stack(msg: 'D', height: 70),
  alignmentTemp: Alignment.bottomCenter,
);
await Future.delayed(Duration(milliseconds: 500));

//center：the stack handler
SmartDialog.show(
  alignmentTemp: Alignment.center,
  isLoadingTemp: false,
  widget: Container(
    decoration: BoxDecoration(
        color: Colors.white, borderRadius: BorderRadius.circular(15)),
    padding: EdgeInsets.symmetric(horizontal: 30, vertical: 20),
    child: Wrap(spacing: 20, children: [
      ElevatedButton(
        child: Text('close dialog A'),
        onPressed: () => SmartDialog.dismiss(tag: 'A'),
      ),
      ElevatedButton(
        child: Text('close dialog B'),
        onPressed: () => SmartDialog.dismiss(tag: 'B'),
      ),
      ElevatedButton(
        child: Text('close dialog C'),
        onPressed: () => SmartDialog.dismiss(tag: 'C'),
      ),
      ElevatedButton(
        child: Text('close dialog D'),
        onPressed: () => SmartDialog.dismiss(tag: 'D'),
      ),
    ]),
  ),
);

[圖片上傳失敗...(image-a91961-1641222341623)]

Loading篇

避坑指南

• 開啟loading后晓铆，可以使用以下方式關(guān)閉
  • SmartDialog.dismiss()：可以關(guān)閉loading和dialog
  • status設(shè)置為SmartStatus.loading：僅僅關(guān)閉loading

// easy close
SmartDialog.dismiss();
// exact close
SmartDialog.dismiss(status: SmartStatus.loading);

• 一般來說，loading彈窗是封裝在網(wǎng)絡(luò)庫里面的绰播，隨著請求狀態(tài)的自動開啟和關(guān)閉
  • 基于這種場景骄噪，我建議：使用dismiss時，加上status參數(shù)蠢箩，將其設(shè)置為：SmartStatus.loading
• 坑比場景
  • 網(wǎng)絡(luò)請求加載的時候链蕊，loading也隨之打開，這時很容易誤觸返回按鈕谬泌，關(guān)閉loading
  • 當(dāng)網(wǎng)絡(luò)請求結(jié)束時示弓，會自動調(diào)用dismiss方法
  • 因為loading已被關(guān)閉，假設(shè)此時頁面又有SmartDialog的彈窗呵萨，未設(shè)置status的dismiss就會關(guān)閉SmartDialog的彈窗
  • 當(dāng)然，這種情況很容易解決跨跨，封裝進(jìn)網(wǎng)絡(luò)庫的loading潮峦，使用：SmartDialog.dismiss(status: SmartStatus.loading); 關(guān)閉就行了
• status參數(shù)囱皿，是為了精確關(guān)閉對應(yīng)類型彈窗而設(shè)計的參數(shù)，在一些特殊場景能起到巨大的作用
  • 如果大家理解這個參數(shù)的含義忱嘹，那對于何時添加status參數(shù)嘱腥，必能胸有成竹

參數(shù)說明

參數(shù)在注釋里面寫的十分詳細(xì)，就不贅述了拘悦，來看看效果

image-20211031215728656

• maskWidgetTemp：強(qiáng)大的遮罩自定義功能??齿兔，發(fā)揮你的腦洞吧。础米。分苇。

var maskWidget = Container(
  width: double.infinity,
  height: double.infinity,
  child: Opacity(
    opacity: 0.6,
    child: Image.network(
      'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101103911.jpeg',
      fit: BoxFit.fill,
    ),
  ),
);
SmartDialog.showLoading(maskWidgetTemp: maskWidget);

[圖片上傳失敗...(image-d72af8-1641222341623)]

• maskColorTemp：支持快捷自定義遮罩顏色

SmartDialog.showLoading(maskColorTemp: randomColor().withOpacity(0.3));

/// random color
Color randomColor() => Color.fromRGBO(
    Random().nextInt(256), Random().nextInt(256), Random().nextInt(256), 1);

loadingTwo

• background：支持加載背景自定義

SmartDialog.showLoading(background: randomColor());

/// random color
Color randomColor() => Color.fromRGBO(
    Random().nextInt(256), Random().nextInt(256), Random().nextInt(256), 1);

loadingThree

• isLoadingTemp：動畫效果切換

SmartDialog.showLoading(isLoadingTemp: false);

loadingFour

• isPenetrateTemp：交互事件可以穿透遮罩，這是個十分有用的功能屁桑，對于一些特殊的需求場景十分關(guān)鍵

SmartDialog.showLoading(isPenetrateTemp: true);

loadingFive

自定義Loading

使用showLoading可以輕松的自定義出強(qiáng)大的loading彈窗医寿；鄙人腦洞有限，就簡單演示下

自定義一個loading布局

class CustomLoading extends StatefulWidget {
  const CustomLoading({Key? key, this.type = 0}) : super(key: key);

  final int type;

  @override
  _CustomLoadingState createState() => _CustomLoadingState();
}

class _CustomLoadingState extends State<CustomLoading>
    with TickerProviderStateMixin {
  late AnimationController _controller;

  @override
  void initState() {
    _controller = AnimationController(
      duration: const Duration(milliseconds: 800),
      vsync: this,
    );
    _controller.forward();
    _controller.addStatusListener((status) {
      if (status == AnimationStatus.completed) {
        _controller.reset();
        _controller.forward();
      }
    });
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Stack(children: [
      // smile
      Visibility(visible: widget.type == 0, child: _buildLoadingOne()),

      // icon
      Visibility(visible: widget.type == 1, child: _buildLoadingTwo()),

      // normal
      Visibility(visible: widget.type == 2, child: _buildLoadingThree()),
    ]);
  }

  Widget _buildLoadingOne() {
    return Stack(alignment: Alignment.center, children: [
      RotationTransition(
        alignment: Alignment.center,
        turns: _controller,
        child: Image.network(
          'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101174606.png',
          height: 110,
          width: 110,
        ),
      ),
      Image.network(
        'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101181404.png',
        height: 60,
        width: 60,
      ),
    ]);
  }

  Widget _buildLoadingTwo() {
    return Stack(alignment: Alignment.center, children: [
      Image.network(
        'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101162946.png',
        height: 50,
        width: 50,
      ),
      RotationTransition(
        alignment: Alignment.center,
        turns: _controller,
        child: Image.network(
          'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101173708.png',
          height: 80,
          width: 80,
        ),
      ),
    ]);
  }

  Widget _buildLoadingThree() {
    return Center(
      child: Container(
        height: 120,
        width: 180,
        decoration: BoxDecoration(
          color: Colors.white,
          borderRadius: BorderRadius.circular(15),
        ),
        alignment: Alignment.center,
        child: Column(mainAxisSize: MainAxisSize.min, children: [
          RotationTransition(
            alignment: Alignment.center,
            turns: _controller,
            child: Image.network(
              'https://cdn.jsdelivr.net/gh/xdd666t/MyData@master/pic/flutter/blog/20211101163010.png',
              height: 50,
              width: 50,
            ),
          ),
          Container(
            margin: EdgeInsets.only(top: 20),
            child: Text('loading...'),
          ),
        ]),
      ),
    );
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }
}

來看看效果

• 效果一

SmartDialog.showLoading(isLoadingTemp: false, widget: CustomLoading());
await Future.delayed(Duration(seconds: 2));
SmartDialog.dismiss();

[圖片上傳失敗...(image-6b6bb7-1641222341623)]

• 效果二

SmartDialog.showLoading(
    isLoadingTemp: false,
    widget: CustomLoading(type: 1),
);
await Future.delayed(Duration(seconds: 2));
SmartDialog.dismiss();

loadingIcon

• 效果三

SmartDialog.showLoading(widget: CustomLoading(type: 2));
await Future.delayed(Duration(seconds: 2));
SmartDialog.dismiss();

loadingNormal

Toast篇

toast的特殊性

嚴(yán)格來說蘑斧，toast是一個非常特殊的彈窗靖秩，我覺得理應(yīng)具備下述的特征

toast消息理應(yīng)一個個展示，后續(xù)消息不應(yīng)該頂?shù)羟懊娴膖oast

• 這是一個坑點竖瘾，如果框架內(nèi)部不做處理，很容易出現(xiàn)后面toast會直接頂?shù)羟懊鎡oast的情況
  • 當(dāng)然捕传，內(nèi)部提供了type參數(shù)，你可以選擇你想要的顯示邏輯

toastOne

展示在頁面最上層求橄，不應(yīng)該被一些彈窗之類遮擋

• 可以發(fā)現(xiàn)loading和dialog的遮罩等布局罐农，均未遮擋toast信息

[圖片上傳失敗...(image-4cb1b-1641222341623)]

對鍵盤遮擋情況做處理

• 鍵盤這玩意有點坑催什，會直接遮擋所有布局，只能曲線救國
  • 在這里做了一個特殊處理蒲凶，當(dāng)喚起鍵盤的時候，toast自己會動態(tài)的調(diào)整自己和屏幕底部的距離
  • 這樣就能起到一個宠默，鍵盤不會遮擋toast的效果

toastSmart

自定義Toast

參數(shù)說明

toast的一些參數(shù)并未向外暴露，僅僅暴露了msg和alignment

• 例如：toast字體大小灵巧，字體顏色搀矫，toast的背景色等等之類抹沪，都沒提供參數(shù)
  • 一是覺得提供了這些參數(shù)，會讓整體參數(shù)輸入變的非常多瓤球，亂花漸入迷人眼
  • 二是覺得就算我提供了很多參數(shù)融欧，也不一定會滿足那些奇奇怪怪的審美和需求
• 基于上述的考慮，我直接提供了大量的底層參數(shù)
  • 你可以隨心所欲的定制toast
    • 注意喔卦羡，不僅僅可以定制toast噪馏，例如：成功提示，失敗提示绿饵，警告提示等等
    • Toast做了很多的優(yōu)化欠肾，type參數(shù)，讓你能擁有多種顯示邏輯蝴罪，發(fā)揮你的想象力吧
  • 注意：使用了widget參數(shù)董济，msg和alignment參數(shù)會失效

image-20211217142656380

調(diào)整toast顯示的位置

SmartDialog.showToast('the toast at the bottom');
SmartDialog.showToast('the toast at the center', alignment: Alignment.center);
SmartDialog.showToast('the toast at the top', alignment: Alignment.topCenter);

toastLocation

更強(qiáng)大的自定義toast

• 首先，整一個自定義toast

class CustomToast extends StatelessWidget {
  const CustomToast(this.msg, {Key? key}) : super(key: key);

  final String msg;

  @override
  Widget build(BuildContext context) {
    return Align(
      alignment: Alignment.bottomCenter,
      child: Container(
        margin: EdgeInsets.only(bottom: 30),
        padding: EdgeInsets.symmetric(horizontal: 20, vertical: 7),
        decoration: BoxDecoration(
          color: _randomColor(),
          borderRadius: BorderRadius.circular(100),
        ),
        child: Row(mainAxisSize: MainAxisSize.min, children: [
          //icon
          Container(
            margin: EdgeInsets.only(right: 15),
            child: Icon(Icons.add_moderator, color: _randomColor()),
          ),

          //msg
          Text('$msg', style: TextStyle(color: Colors.white)),
        ]),
      ),
    );
  }

  Color _randomColor() {
    return Color.fromRGBO(
      Random().nextInt(256),
      Random().nextInt(256),
      Random().nextInt(256),
      1,
    );
  }
}

• 使用

SmartDialog.showToast('', widget: CustomToast('custom toast'));

• 效果

toastCustom

騷氣的小技巧

有一種場景比較蛋筒

• 我們使用StatefulWidget封裝了一個小組件
• 在某個特殊的情況要门，我們需要在這個組件外部虏肾，去觸發(fā)這個組件內(nèi)部的一個方法
• 對于這種場景，有不少實現(xiàn)方法欢搜，但是弄起來可能有點麻煩

這里提供一個簡單的小思路封豪，可以非常輕松的觸發(fā)，組件內(nèi)部的某個方法

• 建立一個小組件

class OtherTrick extends StatefulWidget {
  const OtherTrick({Key? key, this.onUpdate}) : super(key: key);

  final Function(VoidCallback onInvoke)? onUpdate;

  @override
  _OtherTrickState createState() => _OtherTrickState();
}

class _OtherTrickState extends State<OtherTrick> {
  int _count = 0;

  @override
  void initState() {
    // here
    widget.onUpdate?.call(() {
      _count++;
      setState(() {});
    });

    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Container(
        padding: EdgeInsets.symmetric(horizontal: 50, vertical: 20),
        decoration: BoxDecoration(
          color: Colors.white,
          borderRadius: BorderRadius.circular(10),
        ),
        child: Text('Counter： $_count ', style: TextStyle(fontSize: 30.0)),
      ),
    );
  }
}

• 展示這個組件炒瘟，然后外部觸發(fā)它

VoidCallback? callback;

// display
SmartDialog.show(
  alignmentTemp: Alignment.center,
  widget: OtherTrick(
    onUpdate: (VoidCallback onInvoke) => callback = onInvoke,
  ),
);

await Future.delayed(Duration(milliseconds: 500));

// handler
SmartDialog.show(
  alignmentTemp: Alignment.centerRight,
  maskColorTemp: Colors.transparent,
  widget: Container(
    height: double.infinity,
    width: 150,
    color: Colors.white,
    alignment: Alignment.center,
    child: ElevatedButton(
      child: Text('add'),
      onPressed: () => callback?.call(),
    ),
  ),
);

• 來看下效果

[圖片上傳失敗...(image-7e006e-1641222341623)]

最后

相關(guān)地址

• github：flutter_smart_dialog
• 文中demo地址：flutter_use
• demo演示效果：在線體驗

哎疮装，人總是在不斷的迷茫中前行。刷袍。。

夢