[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9149":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":16,"starSnapshotCount":16,"syncStatus":32,"lastSyncTime":33,"discoverSource":34},9149,"flutter_easy_refresh","xuelongqy\u002Fflutter_easy_refresh","xuelongqy","A flutter widget that provides pull-down refresh and pull-up load.","https:\u002F\u002Fxuelongqy.github.io\u002Fflutter_easy_refresh\u002F",null,"Dart",4055,659,39,60,0,1,5,30.46,"MIT License",false,"v3",true,[25,26,27,28],"easy-refresh","flutter","load-more","refresh","2026-06-12 02:02:03","# flutter_easy_refresh\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](\u002FLICENSE)\n[![Platform Flutter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Flutter-blue.svg)](https:\u002F\u002Fflutter.dev)\n[![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh)\n\n## English | [中文](https:\u002F\u002Fgithub.com\u002Fxuelongqy\u002Fflutter_easy_refresh\u002Fblob\u002Fv3\u002FREADME_CN.md)\n\nJust like the name, EasyRefresh can easily implement pull-down refresh and pull-up load on Flutter applications. It supports almost all Flutter Scrollable widgets. Its function is very similar to Android's SmartRefreshLayout, and it also absorbs the advantages of many third-party libraries. EasyRefresh integrates various styles of Header and Footer, but it has no limitations, you can easily customize it. Using Flutter's powerful animations, even just a simple control can be done. The goal of EasyRefresh is to create a powerful, stable and mature pull-to-refresh framework for Flutter.\n\n### [Online demo](https:\u002F\u002Fxuelongqy.github.io\u002Fflutter_easy_refresh\u002F)\n\n### [APK download](https:\u002F\u002Fgithub.com\u002Fxuelongqy\u002Fflutter_easy_refresh\u002Freleases)\n\n### [API reference](https:\u002F\u002Fpub.dev\u002Fdocumentation\u002Feasy_refresh\u002Flatest\u002F)\n\n## Features:\n\n- Supports all scrollable widgets\n- Scrolling physics scope, exactly matching scrollable widgets\n- Integrate multiple cool Header and Footer\n- Support custom styles to achieve various animation effects\n- Support pull-down refresh, pull-up load (Can be triggered and finished with a controller)\n- Support indicator position setting, combined with listeners can also be placed in any position\n- Support refresh when the page starts, and customize the view\n- Support safe area, no more occlusion\n- Customize scroll parameters to allow lists to have different scrolling feedback and inertia\n\n## Companion Packages\n\nFor pagination helpers, use the standalone `easy_paging` [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_paging)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_paging) package.\n\n```dart\nimport 'package:easy_paging\u002Feasy_paging.dart';\nimport 'package:easy_refresh\u002Feasy_refresh.dart';\n```\n\nSample implementation: `example\u002Flib\u002Fpage\u002Fsample\u002Fpaging_page.dart`\n\n## Sample\n\n#### 1. Default constructor\n\n- In the child scope, all scrolling components will share one physics. If there is scroll nesting, use EasyRefresh.builder or set the scope with ScrollConfiguration\n\n```dart\n  EasyRefresh(\n    onRefresh: () async {\n      ....\n    },\n    onLoad: () async {\n      ....\n    },\n    child: ListView(),\n  );\n```\n\n#### 2. Builder constructor\n\n```dart\n  EasyRefresh.builder(\n    onRefresh: () async {\n      ....\n      return IndicatorResult.success;\n    },\n    onLoad: () async {\n      ....\n    },\n    childBuilder: (context, physics) {\n      return ListView(\n        physics: physics,\n      );\n    },\n  );\n```\n\n#### 3. Indicator locate\n\n```dart\n  EasyRefresh(\n    header: Header(\n      position: IndicatorPosition.locator,\n    ),\n    footer: Footer(\n      position: IndicatorPosition.locator,\n    ),\n    onRefresh: () async {\n      ....\n    },\n    onLoad: () async {\n      ....\n      return IndicatorResult.noMore;\n    },\n    child: CustomScrollView(\n      slivers: [\n        SliverAppBar(),\n        const HeaderLocator.sliver(),\n        ...\n        const FooterLocator.sliver(),\n      ],\n    ),\n  );\n```\n\n#### 4. Use controller\n\n```dart\n  EasyRefreshController _controller = EasyRefreshController(\n    controlFinishRefresh: true,\n    controlFinishLoad: true,\n  );\n  ....\n  EasyRefresh(\n    controller: _controller,\n    onRefresh: () async {\n      ....\n      _controller.finishRefresh();\n      _controller.resetFooter();\n    },\n    onLoad: () async {\n      ....\n      _controller.finishLoad(IndicatorResult.noMore);\n    },\n    ....\n  );\n  ....\n  _controller.callRefresh();\n  _controller.callLoad();\n```\n\n#### 5. Specify Header and Footer\n\n```dart\n  EasyRefresh(\n    header: MaterialHeader(),\n    footer: MaterialFooter(),\n    child: ListView(),\n    ....\n  );\n  \u002F\u002F Global\n  EasyRefresh.defaultHeaderBuilder = () => ClassicHeader();\n  EasyRefresh.defaultFooterBuilder = () => ClassicFooter();\n```\n\n#### 6. NestedScrollView\n\n```dart\n  EasyRefresh.builder(\n    header: MaterialHeader(\n      clamping: true,\n    ),\n    onRefresh: () async {\n      ....\n    },\n    onLoad: () async {\n      ....\n    },\n    childBuilder: (context, physics) {\n      return NestedScrollView(\n        physics: physics,\n        body: ListView(\n          physics: physics,\n        );\n      );\n    },\n  );\n  \u002F\u002F or\n  EasyRefresh.builder(\n    header: MaterialHeader(\n      clamping: true,\n      position: IndicatorPosition.locator,\n    ),\n    onRefresh: () async {\n      ....\n    },\n    onLoad: () async {\n      ....\n    },\n    childBuilder: (context, physics) {\n      return NestedScrollView(\n        physics: physics,\n        headerSliverBuilder: (context, innerBoxIsScrolled) {\n          return [\n            const HeaderLocator.sliver(clearExtent: false),\n            ....\n          ];\n        },\n        body: ListView(\n          physics: physics,\n        );\n      );\n    },\n  );\n```\n\n## Style Packages\n\n| Package                                                                   | Pub                                                                                                            |\n| ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |\n| [easy_refresh_bubbles](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_bubbles)     | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_bubbles)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_bubbles)     |\n| [easy_refresh_bow](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_bow)             | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_bow)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_bow)             |\n| [easy_refresh_halloween](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_halloween) | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_halloween)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_halloween) |\n| [easy_refresh_skating](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_skating)     | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_skating)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_skating)     |\n| [easy_refresh_space](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_space)         | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_space)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_space)         |\n| [easy_refresh_squats](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_squats)       | [![Pub](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Feasy_refresh_squats)](https:\u002F\u002Fpub.dev\u002Fpackages\u002Feasy_refresh_squats)       |\n\n## Feel free to contribute\n\nOne's maintenance is lonely. If you have good suggestions and changes, feel free to contribute your code. If you have really cool styles, It's even cooler to share with everyone.\n\n#### Thanks to all the people who already contributed!\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fxuelongqy\u002Fflutter_easy_refresh\u002Fgraphs\u002Fcontributors\">\n    \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=xuelongqy\u002Fflutter_easy_refresh\" \u002F>\n\u003C\u002Fa>\n\n## QQ Group - 554981921\n\n#### Into the group of instructions\n\nThe group is not only solve the problem of EasyRefresh, any Flutter related issues can be discussed. Just as its name, craigslist, as long as there is time, group of Lord will help you solve problems together.\n\n## Thanks\n\n[SmartRefreshLayout](https:\u002F\u002Fgithub.com\u002Fscwang90\u002FSmartRefreshLayout)  \n[flutter_spinkit](https:\u002F\u002Fgithub.com\u002Fjogboms\u002Fflutter_spinkit)\n\n## Licenses\n\n```\n\nMIT License\n\nCopyright (c) 2018 xuelongqy\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and\u002For sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\n\n```\n","flutter_easy_refresh 是一个用于 Flutter 应用的下拉刷新和上拉加载更多功能的小部件。它支持几乎所有可滚动的 Flutter 组件，并且提供了多种风格的头部和尾部样式，同时允许开发者自定义以实现各种动画效果。该项目还支持通过控制器触发刷新或加载动作、设置指示器位置以及在页面启动时自动刷新等功能，非常适合需要列表数据动态更新的应用场景，如新闻应用、社交媒体或任何需要频繁从服务器获取最新数据的移动应用中使用。",2,"2026-06-11 03:21:28","top_language"]