easy_refresh 4.0.0

A flutter widget that provides pull-down refresh and pull-up load.

4.0.0

Note: This release has breaking changes.

• BREAKING FEAT: migrate to material_ui and cupertino_ui for Flutter 3.47.
• BREAKING: Remove the unused pre-Flutter 3.32 kBezierSpringBuilderBelow3_32 helper.
• FEAT: Expose strokeWidth, strokeAlign, strokeCap, elevation, indicatorMargin, and indicatorPadding on MaterialHeader and MaterialFooter.
• CHORE: Upgrade to material_ui 1.5.0 and cupertino_ui 1.1.1; use floating-point color alpha supported by Flutter 3.47.
• Requires Flutter >= 3.47 and Dart ^3.13.
• Built-in indicators resolve Theme and localizations from package:material_ui / package:cupertino_ui.
• Apps still using package:flutter/material.dart should stay on easy_refresh: ^3.5.1.
• FEAT: NestedScrollView-safe physics, EasyRefresh.nested, and isNested as nested-safe physics (not bouncing patches).
• FIX: NestedScrollView retracts Header before collapsing the AppBar when pushing up, so releasing below trigger no longer starts a refresh.
• FIX: Completing refresh while the NestedScrollView AppBar is collapsed no longer flashes the AppBar background.
• FIX: Nested TabBarView Footer / callLoad bind the visible inner instead of the first attached tab (#735).
• FIX: Inner EasyRefresh auto-adopted into NestedScrollView keeps nested-safe state across parent rebuilds (#758).
• FIX: NestedScrollView ballistic result / RenderBox.size asserts after refresh or load (#627, #652, #908).
• FIX: NestedScrollView ClassicFooter remaining after load (#678).
• FIX: Page-level Nested refresh, per-tab Footer, and per-tab EasyRefresh isolation (#508, #725, #838).
• FIX: EasyRefresh.builder preserves Footer overscroll across keyboard-driven viewport changes (#890).
• FIX: Remove unused ValueNotifier wrappers from ballistic simulation state snapshots (#916).
• FIX: Hide the opposite indicator while refresh/load tasks are mutually exclusive, while preserving non-clamping overscroll (#872).
• FIX: Stop carrying stale Footer rebound velocity after appended content expands the scroll extent (#831).
• FIX: Remove duplicate Cupertino indicator keys that could conflict during AnimatedSwitcher transitions (#719).
• FIX: Allow Header/Footer positions already beyond maxOverOffset to rebound toward the valid range without returning an invalid boundary delta (#650).
• FEAT: Add IndicatorTriggerMode.onEdge for Header/Footer drag-start triggering while preserving the existing anywhere default (#606).
• Ship 3 package skills with complete examples and package-specific guidance.
• Update usage documentation and skill installation instructions.
• FIX: Resume Header/Footer rebound after a tap interrupts the closing animation (#913).
• FIX: Support secondary-page closing gestures and interrupted animations with NestedScrollView, including automatically detected nested positions (#853).

3.5.1

• FIX: Use withAlpha instead of withValues (https://github.com/xuelongqy/flutter_easy_refresh/issues/911).

3.5.0

• 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.0

• 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.5+1

• fix: Indicator properties cannot be updated #818.

3.3.5

• fix: Material style performance optimization #814.
• fix: Issue during build when IndicatorStateListenable rebinds IndicatorNotifier #607.

3.3.4

• fix: EasyPaging.itemBuilder type inference #762.
• fix: Event notification after dispose #726.
• fix: Using refreshOnStart, onRefresh may not be triggered #789.
• fix: Using refreshOnStart, scrolling to the bottom when the Header is visible cannot trigger loading #787.

3.3.3+1

• fix: All styles are lost.

3.3.3

• fix: When start on refresh, interrupted by loading #785.
• feat: Use Flutter default scroll bar #775.

3.3.2+4

• fix: IndicatorNotifier._onCanProcess. Null check operator used on a null value #782, #774.

3.3.2+2

• feat: All kind of pointer device are supported by default #777.

3.3.2+1

• fix: Compatible with versions below Flutter3.10 #722.

3.3.2

• 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.1+2

• fix: Secondary click event hit area #688, Thanks notbucai for PR#714.

3.3.1+1

• fix: Increase the priority of ClassicIndicator.pullIconBuilder #674.
• fix: fit parameter is invalid #708.

3.3.1

• fix: Avoid an endless loop caused by multiple ListViews nested, Thanks LinXunFeng for PR#681.
• fix: FooterNotifier.callTask use callRefreshOverOffset, Thanks AWarmHug for PR#680.
• fix: NestedScrollView resize error #666.

3.3.0+1

• fix: Removed compatibility code for list height changes #646, #671.

3.3.0

• fix: Compatible with Flutter 3.7.

3.2.2+2

• fix: The indicator does not retract when the height of the list changes #618.

3.2.2+1

• fix: CupertinoActivityIndicator renamed to avoid conflicts.

3.2.2

• fix: Compatible with Flutter2.8.1 and below #619.
• perf: Pub scores.

3.2.1

• 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.0+1

• fix: When clamping, triggerWhenRelease is true causing the indicator to be stuck.
• feat: Material indicator support triggerWhenRelease.

3.2.0

• feat: EasyRefreshController add headerState, footerState #635.
• feat: Add triggerWhenRelease and triggerWhenReleaseNoWait #593.
• fix: Error when using NotLoadFooter with clamping. Thanks Pwuts for PR#659.
• feat: Add maxOverOffset #590.

3.1.0

• feat: Add paging widget [EasyPaging].

3.0.5+1

• fix: Clamping refresh, causing Material3 AppBar to change color.

3.0.5

• 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.4+4

• fix: Type 'SpringDescription' not found #638.

3.0.4+3

• feat: When the content of the list is not full, the infinite scroll does not cross the bounds #588.

3.0.4+2

• fix: [refreshOnStart] safe area #586.

3.0.4+1

• fix: [NestedScrollView.viewportDimension] should use outer's #582.
• fix: Notify UI to update when indicator property changes #582.

3.0.4

• fix: ScrollMetrics.minScrollExtent != 0.0, offset calculation error.
• feat: Supported [ScrollView.center] #581.

3.0.3+1

• docs: NestedScrollView example.

3.0.3

• fix: processedDuration == Duration.zero, can't rebound #572.
• fix: [clamping] may not have rebound animation.
• fix: Indicator overflow #575.
• fix: BezierCircleHeader drop overflow.
• feat: Supported NestedScrollView.
• feat: Supported ScrollController trigger events.

3.0.2+2

• fix: ClassicIndicator transition animation.
• fix: NotRefreshHeader and NotLoadFooter [position] causes tree structure changes.

3.0.2+1

• fix: [viewportDimension] changes may trigger loading.

3.0.2

• feat: Indicator add [triggerWhenReach] #348. Trigger immediately when reaching the [triggerOffset].
• feat: CupertinoIndicator support horizontal.

3.0.1+1

• fix: CupertinoActivityIndicator radius == 0.

3.0.1

• 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.0+3

• 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.

3.0.0+2

• fix: Scores

3.0.0+1

• fix: .pubignore

3.0.0

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.