玩儿转下拉刷新,FRefresh
image
FWidget 用心提供精致的组件,助您构建精美的应用。
现在,开发者请集中注意力 ?。
思考一下 ?,如何才能构建出下图中的视效呢?
image
经过大脑 ? 的一番飞速旋转,也许我们最终会发现这其中有诈 ? !嗯~这不是一个容易的事情啊。
在下拉的过程中,随着滑动距离的变化,我们需要连续解决几个不同阶段的情况:
临界距离之前的下拉过程
到达临界距离
超过临界距离的下拉过程
自由回弹到刷新位置
保持刷新状态
刷新结束,自由回弹到 0 点位置
未达临界距离回弹到 0 点位置
. . .
每一个过程都需要我们进行大量的计算和逻辑判断。假如再想随着滑动距离对头部 Widget 作出相应调整,那事情就真是很复杂了。
很焦虑吗?
开发者,大可不必!
由于, FRefresh 出现啦!
FRefresh 是由 【阿里巴巴-飞猪-FliggyMobile 技术团队】 开发维护的 FWidget 系列组件之一。
在过去一段时间中,我们已经先后向社区开放了 5 实用精美的 Widget ( FSuper 、 FButton 、 FSwitch 、 FRadio 、 FFloat ),帮助开发者们更易构建出赏心悦目的应用。
我们很高兴取得了开发者们给予的认同和支持,目前我们已经累计收到了开发者们投出的 440 个 Star 。
而今天给开发者们献上的 FRefresh ,正是 FWidget 系列组件中的第 6 个成员。
image | image | image |
image | image | image |
✨ 特性
来看看 FRefresh 都为开发者们准备了些什么:
提供超简单的下拉刷新和上拉加载构建方式
支持局部升级刷新区域和加载区域视图
足够全面的状态机支持
实用的控制器
支持主动触发刷新
image
? 传送区
? 【传送门:FRefresh Github 主页 – 感谢您的 Star ?】
? 【传送门:FRefresh 文档】
? 基础版下拉刷新
就要更简单。
image
这是日常开发中我们最常见的下拉刷新例子 ?。相信我,假如自己想要构建一个这样的效果,会很吃力的!
但假如使用 FRefresh ,情况就完全不同了。
接下来,我们只要要通过简单的几行代码,就能完成这一效果的构建。
FRefresh( /// 构建刷新 Header header: buildRefreshView(), /// 需要传入 Header 区域大小 headerHeight: 75.0, /// 内容区域 Widget child: ListView.builder( physics: NeverScrollableScrollPhysics(), shrinkWrap: true, ... ), /// 进入 Refreshing 后会回调该函数 onRefresh: () {},);完工 ?!
这就是创立下拉刷新所要做的所有工作。
FRefresh 解决好了一切,开发者只要要全身心关注 Header 区域 和 内容区域 的构建工作就够了。
? 进阶版下拉刷新
足够简单,足够高效
image
FRefresh( /// 通过 headerBuilder 构建 Header 区域 headerBuilder: (setter, constraints) { return FSuper( /// 获取当前 Header 区域可用空间大小 width: constraints.maxWidth, height: constraints.maxHeight, ... onClick:{ setter((){ /// 刷新 Header 区域 }) }, ); }, headerHeight: 100.0, /// 构建内容区域 child: GridView.builder(), /// 进入 Refreshing 状态后会回调该函数 onRefresh: () {})FRefresh 提供了一种十分灵活的 Header 区域构建方式,即通过 HeaderBuilder 函数完成构建。
在 HeaderBuilder 函数中,开发者能够通过参数获取到用于局部刷新 Header 区域的刷新函数 StateSetter ,以及 Header 区域 的实时大小。
这种方式,赋予了 Header 区域 更加开放的创造性。
? 基础版上拉加载
两种模式,一种风格
image
与下拉刷新对应,上拉加载效果的构建也同样非比寻常的简单。
FRefresh( /// 构建 Footer 区域 footer: LinearProgressIndicator(), /// 需要配置 Footer 区域高度 footerHeight: 20.0, /// 构建内容区域 child: builderContent(), /// 进入 Loading 状态后会回调该函数 onLoad: () { },)构建上拉加载也一样足够简单。开发者只要要关注 Footer 区域 和 内容区域 的构建,上拉加载过程中的状态变更、视效控制等就放心交给 FRefresh 好了。
? 进阶版上拉加载
不中止追求美的脚步
image
FRefresh( /// 通过 FooterBuilder 构建 Footer 区域 Widget footerBuilder: (setter) { /// 获取刷新状态,局部升级 Footer 区域内容 controller.setOnStateChangedCallback((state) { setter(() { ... }); }); return buildFooter(); }, footerHeight: 38.0, child: buildContent(), onLoad: () { controller.finishLoad(); },)FRefresh 也为 Footer 区域 的构建提供了一个构建函数 FooterBuilder 。通过该函数可以获取到只局部刷新 Footer 区域 的刷新函数 StateSetter 。
这样开发者就能很方便的根据状态或者是其它少量条件改变 Footer 区域 的视图了。
很贴心的吧 ?。
⚙️ FRefreshController
让你掌控全局
image
FRefresh 向开发者提供了贴心的控制器 FRefreshController ,支持诸多便捷的能力。
1. 给 FRefresh 增加控制器
/// 创立 控制器FRefreshController controller = FRefreshController()/// 给 FRefresh 配置控制器FRefresh( controller: controller,)当开发者创立一个控制器,而后将它设置到一个 FRefresh 中后,控制器就能开始监听这个 FRefresh 的状态,以及对它进行控制了。
2. 中止刷新或者加载
当触发刷新状态或者加载状态后,通常会进行网络请求等数据解决任务,在这些任务结束后,我们需要中止刷新状态或者加载状态。怎样办呢?
controller.finishRefresh()可以中止刷新controller.finishLoad()可以中止加载
3. 监听状态
controller5.setOnStateChangedCallback((state) { /// 刷新状态 if (state is RefreshState) { } /// 加载状态 if (state is LoadState) { }});通过上面这段简单的代码,就能实现对 FRefresh 状态变化的监听,不管是下拉刷新,还是上拉加载。
4. 滑动监听
controller.setOnScrollListener((metrics) { /// 获取滑动信息});FRefreshController 增加滑动监听真的是很方便了。接收的参数是 [ScrollMetrics],通过它能获取到诸如 当前滑动距离 、 最大滑动距离 、 能否超出滑动范围 等非常全面的信息。
5. 主动触发刷新
通过 FRefreshController,开发者还能主动触发一次刷新,而且可以指定滑动到触发刷新位置的时长。
controller.refresh(duration: Duration(milliseconds: 2000));这项功能在很多场景中都大有用处。
想要理解更多详细内容?请访问 FRefresh 官方主页 (PS:别忘了投出一个你认可的 Star 哦 ?)。
? 如何使用?
在项目 pubspec.yaml 文件中增加依赖:
? pub 依赖方式
dependencies: frefresh: ^<版本号>⚠️ 注意,请到 pub 获取 FRefresh 最新版本号
? git 依赖方式
dependencies: frefresh: git: url: 'git@github.com:Fliggy-Mobile/frefresh.git' ref: '<分支号 或者 tag>'⚠️ 注意,分支号 或者 tag 请以 FRefresh 官方项目为准。
image
感觉还不错?请到 《FRefresh》的 Github 主页投出您认可的一个 Star ? 吧!
往期组件
《FSuper》- 帮助开发者快速构建精美的复杂视图
《FButton》- 为开发者准备了诸多美妙的配置项
《FSwitch》- 具备优良交互和视效的精美开关元素
《FRadio》- 一个适用于几乎任意单选场景的单选组件
《FFloat》- 满足你对浮动元素的一切想象
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 玩儿转下拉刷新,FRefresh
image
image
image
image
image
image