【重磅发布】Flutter 下拉刷新新库 flutter_chen_refresh:pull_to_refresh 继任者,持续维护,计划支持 NestedSc

225 阅读2分钟

【重磅发布】Flutter 下拉刷新新库 flutter_chen_refresh:pull_to_refresh 继任者,持续维护,计划支持 NestedScrollView!

前言

大家好,我是一名 Flutter 开发者。相信很多人和我一样,在做列表下拉刷新、上拉加载时,都会用到 pull_to_refresh 这个库。它简单易用,功能强大,几乎成了 Flutter 下拉刷新的“标配”。

但遗憾的是,这个库已经4年没有更新了,很多新需求、新问题都无人维护。作为重度用户的我,深感痛心,也遇到了不少坑。于是,我决定接手维护和更新,并基于其思路推出了全新库 flutter_chen_refresh,让它焕发新生!


为什么要继续维护并升级?

  • 用户基数大:pull_to_refresh 在 pub.dev 上下载量数十万。
  • 兼容性问题:Flutter 版本不断升级,原库已出现兼容性 bug。
  • 新需求不断:比如自定义动画、性能优化、国际化等,原库已无法满足。
  • 开源精神:不希望这么优秀的库被时代淘汰。

新库 flutter_chen_refresh 有哪些亮点?

1. 兼容最新 Flutter 版本

  • 适配 Flutter 3.x/4.x,解决了大量兼容性警告和崩溃问题。
  • 支持 null-safety,代码更安全。

2. 性能优化

  • 刷新动画更流畅,内存占用更低。
  • 优化了大数据量场景下的滑动体验。

3. 高度可定制化

  • 支持自定义 Header/Footer,轻松实现个性化刷新动画。
  • 提供多种内置样式,满足不同 UI 风格需求。

4. 更好的文档和示例

  • 全新中文文档,手把手教你用法。
  • 丰富的 Demo,开箱即用。

5. 持续维护,社区共建

  • 欢迎大家提 issue、提 PR,一起让它变得更好。
  • 计划定期发布新版本,响应社区需求。

6. 计划支持 NestedScrollView!

原库在 NestedScrollView 场景下存在兼容性问题,很多开发者反馈无法正常使用。flutter_chen_refresh 已将 NestedScrollView 支持提上日程,未来将彻底解决这一痛点,敬请期待!


如何迁移和使用?

迁移非常简单,只需将 pubspec.yaml 里的依赖指向新库即可。API 基本兼容,老项目无缝升级。

dependencies:
  flutter_chen_refresh: ^最新版本号

简单用法示例:

import 'package:flutter_chen_refresh/flutter_chen_refresh.dart';

RefreshController _refreshController = RefreshController(initialRefresh: false);

SmartRefresher(
  controller: _refreshController,
  onRefresh: _onRefresh,
  onLoading: _onLoading,
  child: ListView.builder(
    itemBuilder: (c, i) => Text("item $i"),
    itemExtent: 100.0,
    itemCount: 20,
  ),
)

更多用法和自定义教程请参考 flutter_chen_refresh


未来规划

  • NestedScrollView 支持:解决原库最大痛点,适配更多复杂场景。
  • 更多内置动画和样式:满足不同产品需求。
  • 国际化支持:让更多开发者用得更顺手。
  • 持续优化性能和体验

结语

如果你也在用下拉刷新,欢迎体验新版 flutter_chen_refresh
如果你有更好的想法,欢迎参与共建!
让我们一起让 Flutter 下拉刷新更简单、更强大!

Star 一下,支持国产开源!
flutter_chen_refresh


本项目已开源,MIT 协议,欢迎自由使用和贡献。

参考:flutter_chen_refresh