feat: add RefreshIndicatorDurations class

Author: gonuit

CHANGELOG.md

@@ -1,7 +1,8 @@
 ## 3.0.0
 - **CustomRefreshIndicator**:
-  - Deprecated *indicatorFinalizeDuration*, *indicatorSettleDuration*, *indicatorCancelDuration* and *completeStateDuration* parameters in favor of *finalizeDuration*, *settleDuration*, *cancelDuration* and *completeDuration*.
+  - 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.

example/lib/indicators/check_mark_indicator.dart

@@ -49,9 +49,12 @@ class _CheckMarkIndicatorState extends State<CheckMarkIndicator> with SingleTick
 
   @override
   Widget build(BuildContext context) {
-    return CustomRefreshIndicator(
+    return CustomMaterialIndicator(
+      withRotation: false,
       onRefresh: () => Future.delayed(const Duration(seconds: 2)),
-      completeDuration: const Duration(seconds: 2),
+      durations: const RefreshIndicatorDurations(
+        completeDuration: Duration(seconds: 2),
+      ),
       onStateChanged: (change) {
         /// set [_renderCompleteState] to true when controller.state become completed
         if (change.didChange(to: IndicatorState.complete)) {
@@ -62,37 +65,34 @@ class _CheckMarkIndicatorState extends State<CheckMarkIndicator> with SingleTick
           _renderCompleteState = false;
         }
       },
-      builder: MaterialIndicatorDelegate(
-        withRotation: false,
-        builder: (
-          BuildContext context,
-          IndicatorController controller,
-        ) {
-          final style = _renderCompleteState ? widget.style.completed : widget.style.loading;
-          return AnimatedContainer(
-            duration: const Duration(milliseconds: 150),
-            alignment: Alignment.center,
-            decoration: BoxDecoration(
-              color: style.background,
-              shape: BoxShape.circle,
-            ),
-            child: _renderCompleteState
-                ? const Icon(
-                    Icons.check,
-                    color: Colors.white,
-                  )
-                : SizedBox(
-                    height: 24,
-                    width: 24,
-                    child: CircularProgressIndicator(
-                      strokeWidth: 2,
-                      color: style.content,
-                      value: controller.isDragging || controller.isArmed ? controller.value.clamp(0.0, 1.0) : null,
-                    ),
+      indicatorBuilder: (
+        BuildContext context,
+        IndicatorController controller,
+      ) {
+        final style = _renderCompleteState ? widget.style.completed : widget.style.loading;
+        return AnimatedContainer(
+          duration: const Duration(milliseconds: 150),
+          alignment: Alignment.center,
+          decoration: BoxDecoration(
+            color: style.background,
+            shape: BoxShape.circle,
+          ),
+          child: _renderCompleteState
+              ? const Icon(
+                  Icons.check,
+                  color: Colors.white,
+                )
+              : SizedBox(
+                  height: 24,
+                  width: 24,
+                  child: CircularProgressIndicator(
+                    strokeWidth: 2,
+                    color: style.content,
+                    value: controller.isDragging || controller.isArmed ? controller.value.clamp(0.0, 1.0) : null,
                   ),
-          );
-        },
-      ).call,
+                ),
+        );
+      },
       child: widget.child,
     );
   }

example/lib/screens/horizontal_screen.dart

@@ -31,20 +31,18 @@ class _HorizontalScreenState extends State<HorizontalScreen> {
         ],
       ),
       body: SafeArea(
-        child: CustomRefreshIndicator(
+        child: CustomMaterialIndicator(
           leadingScrollIndicatorVisible: false,
           trailingScrollIndicatorVisible: false,
           triggerMode: IndicatorTriggerMode.anywhere,
           trigger: IndicatorTrigger.bothEdges,
-          builder: MaterialIndicatorDelegate(
-            builder: (context, controller) {
-              return const Icon(
-                Icons.accessibility,
-                color: Colors.black,
-                size: 30,
-              );
-            },
-          ).call,
+          indicatorBuilder: (context, controller) {
+            return const Icon(
+              Icons.accessibility,
+              color: Colors.black,
+              size: 30,
+            );
+          },
           onRefresh: () => Future.delayed(const Duration(seconds: 2)),
           child: ExampleHorizontalList(
             itemCount: 4,

example/lib/screens/presentation_screen.dart

@@ -20,9 +20,11 @@ class _PresentationScreenState extends State<PresentationScreen> {
       body: SafeArea(
         child: CustomRefreshIndicator(
           trigger: IndicatorTrigger.bothEdges,
-          finalizeDuration: const Duration(seconds: 1),
-          settleDuration: const Duration(seconds: 1),
-          cancelDuration: const Duration(seconds: 1),
+          durations: const RefreshIndicatorDurations(
+            finalizeDuration: Duration(seconds: 1),
+            settleDuration: Duration(seconds: 1),
+            cancelDuration: Duration(seconds: 1),
+          ),
           leadingScrollIndicatorVisible: false,
           trailingScrollIndicatorVisible: false,
           offsetToArmed: 100.0,

lib/src/controller.dart

@@ -77,6 +77,7 @@ class IndicatorController extends Animation<double>
   /// Whether the [edge] was determined by the [CustomRefreshIndicator] widget.
   bool get hasEdge => edge != null;
 
+  @experimental
   DragUpdateDetails? get dragDetails => _dragDetails;
   DragUpdateDetails? _dragDetails;