feat: Add onRemoveFromRoute in DefaultFlashController.

CHANGELOG.md

@@ -1,3 +1,6 @@
+## [3.0.5+2] - 2023-10-27
+- Add `onRemoveFromRoute` in `DefaultFlashController`, it only works when `persistent` is false.
+
 ## [3.0.5+1] - 2023-5-30
 - `FlashBar` add `builder` param to warp child.
 

README.md

@@ -35,7 +35,7 @@ In the `pubspec.yaml` of your flutter project, add the following dependency:
 ```yaml
 dependencies:
   ...
-  flash: ^3.0.5+1
+  flash: ^3.0.5+2
 ```
 
 In your library add the following import:

example/lib/main.dart

@@ -251,6 +251,9 @@ class _FlashPageState extends State<FlashPage> {
                       ElevatedButton(
                         onPressed: () => context.showFlash<bool>(
                           persistent: false,
+                          onRemoveFromRoute: () {
+                            context.showToast(Text('Flash removed'));
+                          },
                           builder: (context, controller) => FlashBar(
                             controller: controller,
                             behavior: FlashBehavior.floating,

example/pubspec.lock

@@ -87,7 +87,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "3.0.5+1"
+    version: "3.0.5+2"
   flutter:
     dependency: "direct main"
     description: flutter

lib/flash_helper.dart

@@ -269,6 +269,7 @@ extension FlashShortcuts on BuildContext {
     FutureOr<bool> Function()? onBarrierTap,
     Curve barrierCurve = Curves.ease,
     bool persistent = true,
+    VoidCallback? onRemoveFromRoute,
     Duration? duration,
     required FlashBuilder<T> builder,
     Completer<T>? dismissCompleter,
@@ -283,6 +284,7 @@ extension FlashShortcuts on BuildContext {
       onBarrierTap: onBarrierTap,
       barrierCurve: barrierCurve,
       persistent: persistent,
+      onRemoveFromRoute: onRemoveFromRoute,
       duration: duration,
       builder: builder,
     );

lib/src/flash_controller.dart

@@ -26,6 +26,7 @@ Future<T?> showFlash<T>({
   Curve barrierCurve = Curves.ease,
   Duration? duration,
   bool persistent = true,
+  VoidCallback? onRemoveFromRoute,
 }) {
   return DefaultFlashController<T>(
     context,
@@ -39,6 +40,7 @@ Future<T?> showFlash<T>({
     barrierCurve: barrierCurve,
     duration: duration,
     persistent: persistent,
+    onRemoveFromRoute: onRemoveFromRoute,
   ).show();
 }
 
@@ -54,6 +56,7 @@ class DefaultFlashController<T> implements FlashController<T> {
     this.onBarrierTap,
     this.barrierCurve = Curves.ease,
     this.persistent = true,
+    this.onRemoveFromRoute,
     this.duration,
   })  : assert(onBarrierTap == null || (barrierDismissible || barrierColor != null || barrierBlur != null)),
         route = ModalRoute.of(context) {
@@ -119,9 +122,11 @@ class DefaultFlashController<T> implements FlashController<T> {
   /// ```
   final bool persistent;
 
+  /// Called when this flash is removed from the history of its associated [LocalHistoryRoute].
+  /// Only works when [persistent] is false.
+  final VoidCallback? onRemoveFromRoute;
+
   /// The animation controller that the route uses to drive the transitions.
-  ///
-  /// The animation itself is exposed by the [animation] property.
   @override
   AnimationController get controller => _controller;
   late AnimationController _controller;
@@ -257,6 +262,7 @@ class DefaultFlashController<T> implements FlashController<T> {
     if (!persistent) {
       _historyEntry = LocalHistoryEntry(onRemove: () {
         assert(!_transitionCompleter.isCompleted, 'Cannot reuse a $runtimeType after disposing it.');
+        onRemoveFromRoute?.call();
         _removedHistoryEntry = true;
         if (!_dismissed) {
           _cancelTimer();

pubspec.yaml

@@ -1,10 +1,10 @@
 name: flash
 description: A highly customizable, powerful and easy-to-use alerting library for Flutter. 
-version: 3.0.5+1
+version: 3.0.5+2
 homepage: https://github.com/sososdk/flash
 
 environment:
-  sdk: ">=2.17.0 <3.0.0"
+  sdk: ">=2.17.0 <4.0.0"
 
 dependencies:
   flutter: