custom_refresh_indicator

• Removed usages of deprecated Flutter APIs. The minimum supported Dart and Flutter versions remain unchanged.

Changes:

• Fixed missing changelog

Full Changelog: v4.0.0...v4.0.1

• CustomRefreshIndicator:
  • Removed deprecated parameters: indicatorCancelDuration, indicatorSettleDuration, indicatorFinalizeDuration and completeStateDuration .If you are still using them, switch to the duration parameter.
  • Improved handling of indicator controller changes.
  • Fixed missing dragDetails data when overscrolling.
• IndicatorController:
  • Added minValue and maxValue static constants.
  • Added transform method. Allows you to transform controller animation values from the range 0.0 → 1.5 to another range.
  • Added normalize method. Normalizes value by converting it to the range 0.0 → 1.0. This allows the animation to be used directly with most Flutter widgets and tweens. You can still use clamp if you want to remove values above 1.0 instead of transforming the whole range.
• CustomMaterialIndicator:
  • Redesigned/reimplemented. Now, when indicatorBuilder argument is not provided, it completely recreates the look and behavior of the built-in RefreshIndicator widget.
  • Added CustomMaterialIndicator.adaptive constructor.
  • indicatorBuilder parameter is now optional.
  • The deprecated parameter withRotation has been removed. It was confusing and was not related to the material indicator design. To add rotation to the indicator, you need to implement rotation yourself 😔.
  • Added color, semanticsValue, semanticsLabel and strokeWidth parameters. They are applied only when the default indicatorBuilder is used (given a null value).
• Removed deprecated IndicatorBuilderDelegate and MaterialIndicatorDelegate classes.
• Added TransformedAnimation class that allows transforming the parent animation value.
• Exposed a PositionedIndicatorContainer widget that allows easy positioning of the indicator.
• Example app:
  • Updated custom material indicator example.
  • Updated application design.
  • Added tooltips.
  • Added ball indicator example, which is an overview of the drag details based indicator.
  • Updated web example.

Changes:

• CustomRefreshIndicator:
  • Removed deprecated parameters: indicatorCancelDuration, indicatorSettleDuration, indicatorFinalizeDuration and completeStateDuration .If you are still using them, switch to the duration parameter.
  • Improved handling of indicator controller changes.
  • Fixed missing dragDetails data when overscrolling.
• IndicatorController:
  • Added minValue and maxValue static constants.
  • Added transform method. Allows you to transform controller animation values from the range 0.0 → 1.5 to another range.
  • Added normalize method. Normalizes value by converting it to the range 0.0 → 1.0. This allows the animation to be used directly with most Flutter widgets and tweens. You can still use clamp if you want to remove values above 1.0 instead of transforming the whole range.
• CustomMaterialIndicator:
  • Redesigned/reimplemented. Now, when indicatorBuilder argument is not provided, it completely recreates the look and behavior of the built-in RefreshIndicator widget.
  • Added CustomMaterialIndicator.adaptive constructor.
  • indicatorBuilder parameter is now optional.
  • The deprecated parameter withRotation has been removed. It was confusing and was not related to the material indicator design. To add rotation to the indicator, you need to implement rotation yourself 😔.
  • Added color, semanticsValue, semanticsLabel and strokeWidth parameters. They are applied only when the default indicatorBuilder is used (given a null value).
• Removed deprecated IndicatorBuilderDelegate and MaterialIndicatorDelegate classes.
• Added TransformedAnimation class that allows transforming the parent animation value.
• Exposed a PositionedIndicatorContainer widget that allows easy positioning of the indicator.
• Example app:
  • Updated custom material indicator example.
  • Updated application design.
  • Added tooltips.
  • Added ball indicator example, which is an overview of the drag details based indicator.
  • Updated web example.

Full Changelog: v3.1.2...v4.0.0

Changes:

• CustomRefreshIndicator:
  • Removed deprecated parameters: indicatorCancelDuration, indicatorSettleDuration, indicatorFinalizeDuration and completeStateDuration .If you are still using them, switch to the duration parameter.
  • Improved handling of indicator controller changes.
  • Fixed missing dragDetails data when overscrolling.
• IndicatorController:
  • Added minValue and maxValue static constants.
  • Added transform method. Allows you to transform controller animation values from the range 0.0 → 1.5 to another range.
  • Added normalize method. Normalizes value by converting it to the range 0.0 → 1.0. This allows the animation to be used directly with most Flutter widgets and tweens. You can still use clamp if you want to remove values above 1.0 instead of transforming the whole range.
• CustomMaterialIndicator:
  • Redesigned/reimplemented. Now, when indicatorBuilder argument is not provided, it completely recreates the look and behavior of the built-in RefreshIndicator widget.
  • Added CustomMaterialIndicator.adaptive constructor.
  • indicatorBuilder parameter is now optional.
  • The deprecated parameter withRotation has been removed. It was confusing and was not related to the material indicator design. To add rotation to the indicator, you need to implement rotation yourself 😔.
  • Added color, semanticsValue, semanticsLabel and strokeWidth parameters. They are applied only when the default indicatorBuilder is used (given a null value).
• Removed deprecated IndicatorBuilderDelegate and MaterialIndicatorDelegate classes.
• Added TransformedAnimation class that allows transforming the parent animation value.
• Exposed a PositionedIndicatorContainer widget that allows easy positioning of the indicator.
• Example app:
  • Updated custom material indicator example.
  • Updated application design.
  • Added tooltips.
  • Added ball indicator example, which is an overview of the drag details based indicator.
  • Updated web example.

Full Changelog: v4.0.0-dev.2...v4.0.0-dev.3

Changes:

• CustomRefreshIndicator:
  • Removed deprecated parameters: indicatorCancelDuration, indicatorSettleDuration, indicatorFinalizeDuration and completeStateDuration .If you are still using them, switch to the duration parameter.
  • Improved handling of indicator controller changes.
  • Fixed missing dragDetails data when overscrolling.
• IndicatorController:
  • Added minValue and maxValue static constants.
  • Added transform method. Allows you to transform controller animation values from the range 0.0 → 1.5 to another range.
  • Added normalize method. Normalizes value by converting it to the range 0.0 → 1.0. This allows the animation to be used directly with most Flutter widgets and tweens. You can still use clamp if you want to remove values above 1.0 instead of transforming the whole range.
• CustomMaterialIndicator:
  • Redesigned/reimplemented. Now, when indicatorBuilder argument is not provided, it completely recreates the look and behavior of the built-in RefreshIndicator widget.
  • Added CustomMaterialIndicator.adaptive constructor.
  • indicatorBuilder parameter is now optional.
  • The deprecated parameter withRotation has been removed. It was confusing and was not related to the material indicator design. To add rotation to the indicator, you need to implement rotation yourself 😔.
  • Added color, semanticsValue, semanticsLabel and strokeWidth parameters. They are applied only when the default indicatorBuilder is used (given a null value).
• Removed deprecated IndicatorBuilderDelegate and MaterialIndicatorDelegate classes.
• Added TransformedAnimation class that allows transforming the parent animation value.
• Exposed a PositionedIndicatorContainer widget that allows easy positioning of the indicator.
• Example app:
  • Updated custom material indicator example.
  • Updated application design.
  • Added tooltips.
  • Added ball indicator example, which is an overview of the drag details based indicator.
  • Updated web example.

Full Changelog: v4.0.0-dev.1...v4.0.0-dev.2

Changes:

• CustomRefreshIndicator:
  • Removed deprecated parameters: indicatorCancelDuration, indicatorSettleDuration, indicatorFinalizeDuration and completeStateDuration .If you are still using them, switch to the duration parameter.
• IndicatorController:
  • Added minValue and maxValue static constants.
  • Added transform method. Allows you to transform controller animation values from the range 0.0 → 1.5 to another range.
  • Added normalize method. Normalizes value by converting it to the range 0.0 → 1.0. This allows the animation to be used directly with most Flutter widgets and tweens. You can still use clamp if you want to remove values above 1.0 instead of transforming the whole range.
• CustomMaterialIndicator:
  • Redesigned/reimplemented. Now, when indicatorBuilder argument is not provided, it completely recreates the look and behavior of the built-in RefreshIndicator widget.
  • Added CustomMaterialIndicator.adaptive constructor.
  • indicatorBuilder parameter is now optional.
  • The deprecated parameter withRotation has been removed. It was confusing and was not related to the material indicator design. To add rotation to the indicator, you need to implement rotation yourself 😔.
  • Added color, semanticsValue, semanticsLabel and strokeWidth parameters. They are applied only when the default indicatorBuilder is used (given a null value).
• Removed deprecated IndicatorBuilderDelegate and MaterialIndicatorDelegate classes.
• Added TransformedAnimation class that allows transforming the parent animation value.
• Example app:
  • Updated custom material indicator example.

Full Changelog: v3.1.1...v4.0.0-dev.1

Changes

• Deprecated the withRotation argument of the CustomMaterialIndicator widget. The rotation function will be removed in the upcoming version.
• Fixed missing drag detail (IndicatorController.dragDetails) information from scroll events.

Full Changelog: v3.1.1...v3.1.2

• Deprecated the withRotation argument of the CustomMaterialIndicator widget. The rotation function will be removed in the upcoming version.
• Fixed missing drag detail (IndicatorController.dragDetails) information from scroll events.

Changes:

• Fix:
  • Fixed durations parameter of CustomRefreshIndicator widget. Reported by @jccd1996 in #58.

Full Changelog: v3.0.0...v3.1.1

• Fix:
  • Fixed durations parameter of CustomRefreshIndicator widget. Reported by @jccd1996 in #58.

• Experimental:
  • Added ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.
• The indicator's cancel duration is now based on the dragging progress.
• Updated the the dart sdk constraints to >=2.17.0 <4.0.0

Changes:

• Experimental:
  • Added ClampingWithOverscrollPhysics scroll physics, that together with indicator controller allows handling overscroll correctly.
• The indicator's cancel duration is now based on the dragging progress.
• Updated the dart sdk constraints to >=2.17.0 <4.0.0
• Updated example app native dependencies

Full Changelog: v3.0.0...v3.1.0-dev.1

Changes:

• CustomRefreshIndicator:
  • Deprecated indicatorFinalizeDuration, indicatorSettleDuration, indicatorCancelDuration and completeStateDuration parameters in favor of durations.
  • The indicator widget will now be rebuilt every time state changes, even if the autoRebuilt parameter is set to false. This will make managing the state of the indicator widget simpler.
  • Deprecated IndicatorDelegate and MaterialIndicatorDelegate in favor of CustomMaterialIndicator widget.
• IndicatorController:
  • The controller now extends Animation. This allows it to be used directly with Transition widgets to further improve animation performance.
  • New ClampedAnimation class for constraining the IndicatorController animation value within a specific range using the clamp method.
  • Drag interaction details are now available, enabling pointer-position-based animations.
• Example app:
  • The checkmark indicator example has been simplified.
  • Minor corrections to the envelope indicator.
  • Added image precaching.
  • Removed unused code.

Full Changelog: v2.2.1...v3.0.0

• CustomRefreshIndicator:
  • Deprecated indicatorFinalizeDuration, indicatorSettleDuration, indicatorCancelDuration and completeStateDuration parameters in favor of durations.
  • The indicator widget will now be rebuilt every time state changes, even if the autoRebuilt parameter is set to false. This will make managing the state of the indicator widget simpler.
  • Deprecated IndicatorDelegate and MaterialIndicatorDelegate in favor of CustomMaterialIndicator widget.
• IndicatorController:
  • The controller now extends Animation<double>. This allows it to be used directly with Transition widgets to further improve animation performance.
  • New ClampedAnimation class for constraining the IndicatorController animation value within a specific range using the clamp method.
  • Drag interaction details are now available, enabling pointer-position-based animations.
• Example app:
  • The checkmark indicator example has been simplified.
  • Minor corrections to the envelope indicator.
  • Added image precaching.
  • Removed unused code.

• Fixed typos in documentation

• Added clipBehavior and the elevation arguments of the MaterialIndicatorDelegate class.

• Updated the dart sdk constraints

• Added missing isCanceling and isSettling getters for IndicatorState and IndicatorController enum.

• Flutter 3.0.0 migration backward compatibility fix (#31) by Jordan1122

Improvements:

• Compatibility improvements for Flutter 3.0.

Fixes:

• Fixed assertion issue reported and resolved by ziqq in #29. For more information, please take a look at the following issue #28

Fixes:

• Pub.dev readme file fix.
• Fix code formatting issues

Fixes:

• Handle errors thrown from the onRefresh method.

Improvements:

• Updated example app
  • Added support for the Android embedding v2
  • Added web support
  • Added windows support.
• Added a web based demo app (url in the readme file).
• Replaced the deprecated disallowGlow method calls with disallowIndicator.
• Added onStateChanged function argument that allows tracking indicator state changes.
• The IndicatorStateHelper class is now deprecated in favor of onStateChange function and IndicatorStateChange class.
• Initial support for programmatically-controlled indicators has been added. Added the show, hide and refresh methods to the CustomRefreshIndicatorState class. It can be accessed via GlobalKey. Take a look at an programmatically-controlled screen example.
• Use the flutter_lints package for analysis.
• Deprecate leadingGlowVisible and trailingGlowVisible in favor of leadingScrollIndicatorVisible and trailingScrollIndicatorVisible arguments.
• Added reversed argument that allows you to trigger a refresh indicator from the end of the list.
• Added envelope example.
• Added pull to fetch more example.

• Stable nullsafety release.
• BREAKING: opt into null safety
  • Dart SDK constraints: >=2.12.0-0 <3.0.0
• BREAKING: Removed prevState from IndicatorController class. Because flutter only marks the widget that it is ready for rebuild, it is possible that the controller state will change more than once during a single frame what causes one or more steps to be skipped. To still use prevState and didChangeState method, you can use IndicatorStateHelper. Take a look at check_mark_indicator.dart or warp_indicator.dart for example usage.
• Added IndicatorStateHelper class.
• Added IndicatorController unit tests.
• Added warp indicator example.
• Added stopDrag method to the IndicatorController class. It allows you to stop current user drag.

• Improved readme documentation.
• Removed material package import.

• Added isComplete and wasComplete controller getters.
• Removed axis property as it can be handled by notificationPredicate.

• Added optional complete indicator state together with completeStateDuration parameter.
• IndicatorController changes:
  • Added previousState property.
  • Added didStateChange helper method.
  • Added wasArmed, wasDragging, wasLoading, wasHiding and wasIdle properties.
• Added notificationPredicate property to the CustomRefreshIndicator widget.
• Example app:
  • Added initial version of check_mark_indicator. Example that shows how to make use of complete state.

• Upgrade example to AndroidX
• Improved README

• Added support for BouncingScrollPhysics - ios default scroll physics
• Improved readme

• Extracted inbox example to letter_refresh_indicator package

• Added basic CustomRefreshIndicator widget with CustomRefreshIndicatorData class.
• Added SimpleIndicatorContainer widget which simulate default RefreshIndicator container
• Added examples:
  • inbox
  • simple
  • blur