首先, 使用 FlutterEasyLoading 组件包裹您的App组件:
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
/// 子组件通常为 [MaterialApp] 或者 [CupertinoApp].
/// 这样做是为了确保 loading 组件能覆盖在其他组件之上.
return FlutterEasyLoading(
child: MaterialApp(
title: ‘Flutter EasyLoading’,
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(title: ‘Flutter EasyLoading’),
),
);
}
}
然后, 请尽情使用吧:
EasyLoading.show(status: ‘loading…’);
EasyLoading.showProgress(0.3, status: ‘downloading…’);
EasyLoading.showSuccess(‘Great Success!’);
EasyLoading.showError(‘Failed with Error’);
EasyLoading.showInfo(‘Useful Information.’);
EasyLoading.dismiss();
自定义样式
首先,我们看下Flutter EasyLoading目前支持的自定义属性:
/// loading的样式, 默认[EasyLoadingStyle.dark].
EasyLoadingStyle loadingStyle;
/// loading的指示器类型, 默认[EasyLoadingIndicatorType.fadingCircle].
EasyLoadingIndicatorType indicatorType;
/// loading的遮罩类型, 默认[EasyLoadingMaskType.none].
EasyLoadingMaskType maskType;
/// 文本的对齐方式 , 默认[TextAlign.center].
TextAlign textAlign;
/// loading内容区域的内边距.
EdgeInsets contentPadding;
/// 文本的内边距.
EdgeInsets textPadding;
/// 指示器的大小, 默认40.0.
double indicatorSize;
/// loading的圆角大小, 默认5.0.
double radius;
/// 文本大小, 默认15.0.
double fontSize;
/// 进度条指示器的宽度, 默认2.0.
double progressWidth;
/// [showSuccess] [showError] [showInfo]的展示时间, 默认2000ms.
Duration displayDuration;
/// 文本的颜色, 仅对[EasyLoadingStyle.custom]有效.
Color textColor;
/// 指示器的颜色, 仅对[EasyLoadingStyle.custom]有效.
Color indicatorColor;
/// 进度条指示器的颜色, 仅对[EasyLoadingStyle.custom]有效.
Color progressColor;
/// loading的背景色, 仅对[EasyLoadingStyle.custom]有效.
Color backgroundColor;
/// 遮罩的背景色, 仅对[EasyLoadingMaskType.custom]有效.
Color maskColor;
/// 当loading展示的时候,是否允许用户操作.
bool userInteractions;
/// 展示成功状态的自定义组件
Widget successWidget;
/// 展示失败状态的自定义组件
Widget errorWidget;
/// 展示信息状态的自定义组件
Widget infoWidget;
因为 EasyLoading
是一个全局单例, 所以我们可以在任意一个地方自定义它的样式:
EasyLoading.instance
…displayDuration = const Duration(milliseconds: 2000)
…indicatorType = EasyLoadingIndicatorType.fadingCircle
…loadingStyle = EasyLoadingStyle.dark
…indicatorSize = 45.0
…radius = 10.0
…backgroundColor = Colors.green
…indicatorColor = Colors.yellow
…textColor = Colors.yellow
…maskColor = Colors.blue.withOpacity(0.5);
更多的指示器动画类型可查看 flutter_spinkit showcase
可以看到,Flutter EasyLoading的集成以及使用相当的简单,而且有丰富的自定义样式,总会有你满意的。
接下来,我们来看看Flutter EasyLoading的代码实现。
Flutter EasyLoading 的实现
本文将通过以下两个知识点来介绍Flutter EasyLoading的主要实现过程及思路:
Overlay
、OverlayEntry
实现全局弹窗CustomPaint
与Canvas
实现圆形进度条绘制Overlay
、OverlayEntry
实现全局弹窗
先看看官方关于Overlay的描述:
/// A [Stack] of entries that can be managed independently.
///
/// Overlays let independent child widgets “float” visual elements on top of
/// other widgets by inserting them into the overlay’s [Stack]. The overlay lets
/// each of these widgets manage their participation in the overlay using
/// [OverlayEntry] objects.
///
/// Although you can create an [Overlay] directly, it’s most common to use the
/// overlay created by the [Navigator] in a [WidgetsApp] or a [MaterialApp]. The
/// navigator uses its overlay to manage the visual appearance of its routes.
///
/// See also:
///
/// * [OverlayEntry].
/// * [OverlayState].
/// * [WidgetsApp].
/// * [MaterialApp].
class Overlay extends StatefulWidget {}
也就是说,Overlay
是一个Stack的Widget
,可以将OverlayEntry
插入到Overlay中,使独立的child
窗口悬浮于其他Widget之上。利用这个特性,我们可以用Overlay
将 MaterialApp或CupertinoApp
包裹起来,这样做的目的是为了确保 loading
组件能覆盖在其他组件之上,因为在Flutter
中只会存在一个MaterialApp
或CupertinoApp
根节点组件。(注:这里的做法参考于flutter_oktoast
插件,感谢)。
另外,这样做的目的还可以解决另外一个核心问题:将 context
缓存到内存中,后续所有调用均不需要提供context
。实现如下:
@override
Widget build(BuildContext context) {
return Directionality(
child: Overlay(
initialEntries: [
OverlayEntry(
builder: (BuildContext _context) {
// 缓存 context
EasyLoading.instance.context = _context;
// 这里的child必须是MaterialApp或CupertinoApp
return widget.child;
},
),
],
),
textDirection: widget.textDirection,
);
}
// 创建OverlayEntry
OverlayEntry _overlayEntry = OverlayEntry(
builder: (BuildContext context) => LoadingContainer(
key: _key,
status: status,
indicator: w,
animation: _animation,
),
);
// 将OverlayEntry插入到Overlay中
// 通过Overlay.of()我们可以获取到App根节点的Overlay
Overlay.of(_getInstance().context).insert(_overlayEntry);
// 调用OverlayEntry自身的remove()方法,从所在的Overlay中移除自己
_overlayEntry.remove();
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级安卓工程师,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年最新Android移动开发全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注Android)
-1710924360698)]
[外链图片转存中…(img-jtM554es-1710924360698)]
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注Android)
[外链图片转存中…(img-CasIAPWb-1710924360699)]