easy_refresh
A flutter widget that provides pull-down refresh and pull-up load.
3.5.1
44K downloads/mo
#1546 most downloaded on pub.dev
xuelongqy/flutter_easy_refresh
What this package is like to depend on
Last release 2 months ago
14 Jun 2026
Ships unpredictably
gaps range from 2 weeks to 1.9 years
Nearly every release is documented
notes for 42 of 43 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
43 releases · first in 2022
2 releases in the last 12 months
see the full history below
Release timeline
43 releases · Jul 2022 to Jun 2026
2023
2024
2025
2026
Releases
latest 43-
3.5.114 Jun 2026Release notes
Open source →- FIX: Use withAlpha instead of withValues (https://github.com/xuelongqy/flutter_easy_refresh/issues/911).
-
3.5.023 Mar 2026Release notes
Open source →- FIX: material clamping spring (#885) (#620).
- FIX: mode unchange when not released (#894).
- FIX: secondary page.
- FIX: effective scroll position.
- FIX: footer mode (#905).
- FIX: clamping animation controller (#907).
- FEAT: easy paging.
- FEAT: update rive.
- FEAT: update readme.
- FEAT: workspace.
- BREAKING FEAT: Added EasyRefresh.isNested parameter to determine whether to handle NestedScrollView. In versions 3.4.0 and earlier, no setting is required.
- FIX: Adjust the Flutter version, Flutter >=3.10.0.
Release notes
Open source →- FIX: material clamping spring (https://github.com/xuelongqy/flutter_easy_refresh/issues/885) (https://github.com/xuelongqy/flutter_easy_refresh/issues/620).
- FIX: mode unchange when not released (https://github.com/xuelongqy/flutter_easy_refresh/issues/894).
- FIX: secondary page.
- FIX: effective scroll position.
- FIX: footer mode (https://github.com/xuelongqy/flutter_easy_refresh/pull/905).
- FIX: clamping animation controller (https://github.com/xuelongqy/flutter_easy_refresh/issues/907).
- FEAT: easy paging.
- FEAT: update rive.
- FEAT: update readme.
- FEAT: workspace.
- BREAKING FEAT: Added EasyRefresh.isNested parameter to determine whether to handle NestedScrollView. In versions 3.4.0 and earlier, no setting is required.
- FIX: Adjust the Flutter version, Flutter >=3.10.0.
-
3.4.014 May 2024Release notes
Open source →- breaking: Flutter >=3.7.0, dart >=2.19.0. Remove some unnecessary compatibility, please update the Flutter version in time, or use the previous version.
- fix: Scroll bar adaptation for unknown platforms #825.
- feat: Add BoxDecoration to ClassicHeader and ClassicFooter, Thanks GiampaoloGabba for PR#822.
- fix: Compatible with Flutter3.22.0.
Release notes
Open source →- breaking: Flutter >=3.7.0, dart >=2.19.0. Remove some unnecessary compatibility, please update the Flutter version in time, or use the previous version.
- fix: Scroll bar adaptation for unknown platforms #825.
- feat: Add BoxDecoration to ClassicHeader and ClassicFooter, Thanks GiampaoloGabba for PR#822.
- fix: Compatible with Flutter3.22.0.
-
3.3.519 Apr 2024 -
3.3.5+124 Apr 2024 -
3.3.429 Dec 2023 -
3.3.313 Dec 2023Release notes
Open source → -
3.3.3+113 Dec 2023 -
3.3.218 May 2023Release notes
Open source →- fix: BezierIndicator.spinBuilder doesn't work.
- feat: Add BezierIndicator.spinInCenter.
- feat: Add BezierIndicator.onlySpin #689.
- feat: Add support for ScrollPhysics.toleranceFor.
- feat: After failure, continue to scroll to trigger the task #718.
- feat: [EasyRefresh] noMoreRefresh -> canRefreshAfterNoMore, noMoreLoad -> canRefreshAfterLoad
- fix: Use canRefreshAfterNoMore or canRefreshAfterLoad, abnormal NoMore status.
- feat: EasyRefreshController.finishRefresh and EasyRefreshController.finishLoad add force parameter.
- feat: Add EasyRefresh.triggerAxis, specifies the direction of the trigger.
-
3.3.2+118 May 2023 -
3.3.2+225 Oct 2023 -
3.3.2+310 Nov 2023Nothing published for this version
-
3.3.2+410 Nov 2023Release notes
Open source → -
3.3.117 Feb 2023 -
3.3.1+114 Apr 2023 -
3.3.1+227 Apr 2023 -
3.3.029 Jan 2023 -
3.3.0+101 Feb 2023 -
3.2.210 Jan 2023 -
3.2.2+111 Jan 2023 -
3.2.2+216 Jan 2023Release notes
Open source →- fix: The indicator does not retract when the height of the list changes #618.
-
3.2.106 Jan 2023Release notes
Open source →- fix: Footer's maxOverOffset property does not work.
- fix: When maxOverOffset is 0, list scrolling loses inertia.
- fix: When there is no task, the mode still changes #608.
- fix: HapticFeedback does not work when triggerWhenReach is true.
-
3.2.030 Dec 2022 -
3.2.0+103 Jan 2023Release notes
Open source →- fix: When clamping, triggerWhenRelease is true causing the indicator to be stuck.
- feat: Material indicator support triggerWhenRelease.
-
3.1.021 Dec 2022 -
3.0.527 Nov 2022Release notes
Open source →- fix: [EasyRefreshController.callRefresh] and [EasyRefreshController.callLoad] add force #633 #642. Thanks percival888 for PR#639.
- fix: When the height changes when callTask causes the list not to rebound.
- feat: Add [EasyRefresh.scrollBehaviorBuilder] and [EasyRefresh.defaultScrollBehaviorBuilder]. Thanks laiiihz for PR#614.
-
3.0.5+112 Dec 2022 -
3.0.401 Aug 2022Release notes
Open source →- fix: ScrollMetrics.minScrollExtent != 0.0, offset calculation error.
- feat: Supported [ScrollView.center] #581.
-
3.0.4+101 Aug 2022 -
3.0.4+209 Aug 2022 -
3.0.4+331 Oct 2022Release notes
Open source →- feat: When the content of the list is not full, the infinite scroll does not cross the bounds #588.
-
3.0.4+406 Nov 2022 -
3.0.331 Jul 2022 -
3.0.3+131 Jul 2022 -
3.0.214 Jul 2022Release notes
Open source →- feat: Indicator add [triggerWhenReach] #348. Trigger immediately when reaching the [triggerOffset].
- feat: CupertinoIndicator support horizontal.
-
3.0.2+115 Jul 2022 -
3.0.2+218 Jul 2022Release notes
Open source →- fix: ClassicIndicator transition animation.
- fix: NotRefreshHeader and NotLoadFooter [position] causes tree structure changes.
-
3.0.111 Jul 2022Release notes
Open source →- fix: Use notifyListeners after ChangeNotifier disposed. Thanks laiiihz for PR#555.
- feat: ClassicHeader、ClassicFooter add IconThemeData. Thanks Lay523 for PR#562.
- feat: ClassicIndicator add [progressIndicatorSize] and [progressIndicatorStrokeWidth].
- feat: Add CupertinoIndicator.
- fix: finishLoad asset #563.
-
3.0.1+112 Jul 2022 -
3.0.007 Jul 2022Release notes
Open source →New version
Framework rewrite, stronger refresh widget.
- Supports all scrollable widgets.
- Physics scope, no longer limited to child types.
- Adjustable scroll parameters, infinite possibilities for the indicator.
- Safe area support.
- Indicator position setting.
-
3.0.0+107 Jul 2022 -
3.0.0+207 Jul 2022 -
3.0.0+308 Jul 2022Release notes
Open source →- fix: dart >=2.13.0.
- fix: The screen is not full, [infinite] can not reset.
- feat: HeaderLocator and FooterLocator add [clearExtent].
- feat: Add OverrideFooter and OverrideHeader.