handlesBackButton

example/lib/src/feature/shop/widget/basket_screen.dart

@@ -17,6 +17,9 @@ class BasketTab extends StatelessWidget {
   @override
   Widget build(BuildContext context) => BucketNavigator(
         bucket: '${ShopTabsEnum.basket}-tab',
+        // Handles back button only if the current route is the basket screen
+        handlesBackButton: () =>
+            Octopus.instance.state.arguments['shop'] == 'basket',
       );
 }
 

example/lib/src/feature/shop/widget/catalog_screen.dart

@@ -24,6 +24,9 @@ class CatalogTab extends StatelessWidget {
   @override
   Widget build(BuildContext context) => BucketNavigator(
         bucket: '${ShopTabsEnum.catalog}-tab',
+        // Handles back button only if the current route is the catalog screen
+        handlesBackButton: () =>
+            Octopus.instance.state.arguments['shop'] == 'catalog',
       );
 }
 

lib/src/controller/information_provider_js.dart

@@ -120,10 +120,8 @@ final class OctopusInformationProvider$JS extends OctopusInformationProvider {
 
   void pushRoute(RouteInformation routeInformation) {
     if (_value == routeInformation) return;
-    if (routeInformation.uri.path.startsWith('/')) return;
-    final uri = routeInformation.uri;
-    _value = RouteInformation(uri: uri, state: null);
-    _valueInEngine = OctopusInformationProvider.kEmptyRouteInformation;
+    //if (routeInformation.uri.path.startsWith('/')) return;
+    _value = _valueInEngine = routeInformation;
     notifyListeners();
   }
 

lib/src/controller/information_provider_vm.dart

@@ -120,10 +120,8 @@ final class OctopusInformationProvider$VM extends OctopusInformationProvider {
 
   void pushRoute(RouteInformation routeInformation) {
     if (_value == routeInformation) return;
-    if (routeInformation.uri.path.startsWith('/')) return;
-    final uri = routeInformation.uri;
-    _value = RouteInformation(uri: uri, state: null);
-    _valueInEngine = OctopusInformationProvider.kEmptyRouteInformation;
+    //if (routeInformation.uri.path.startsWith('/')) return;
+    _value = _valueInEngine = routeInformation;
     notifyListeners();
   }
 

lib/src/widget/bucket_navigator.dart

@@ -15,6 +15,8 @@ import 'package:octopus/src/widget/route_context.dart';
 ///
 /// The [bucket] unique identifier is used to identify the navigator
 /// within the all application.
+/// The [handlesBackButton] parameter is used to decide whether this navigator
+/// should handle back button presses.
 /// The [transitionDelegate] parameter is used to customize the transition
 /// animation.
 /// The [observers] parameter is used to observe the navigation events.
@@ -25,6 +27,7 @@ class BucketNavigator extends StatefulWidget {
   /// {@macro bucket_navigator}
   const BucketNavigator({
     required this.bucket,
+    this.handlesBackButton,
     this.transitionDelegate,
     this.observers = const <NavigatorObserver>[],
     this.restorationScopeId,
@@ -34,6 +37,13 @@ class BucketNavigator extends StatefulWidget {
   /// The unique identifier of the navigator.
   final String bucket;
 
+  /// The [handlesBackButton] parameter is used to decide whether this navigator
+  /// should handle back button presses.
+  /// Usefull when you want to handle back button only when the current screen
+  /// is in focus now.
+  /// By default, the value is `true` if the navigator has more than one page.
+  final bool Function()? handlesBackButton;
+
   /// The delegate that decides how the route transition animation should
   /// look like.
   final TransitionDelegate<Object?>? transitionDelegate;
@@ -141,6 +151,9 @@ class _BucketNavigatorState extends State<BucketNavigator>
   @override
   Future<bool> _onBackButtonPressed() {
     if (!mounted) return Future<bool>.value(false);
+    final handlesBackButton = widget.handlesBackButton;
+    if (handlesBackButton != null && !handlesBackButton())
+      return Future<bool>.value(false);
     final node = _node;
     if (node == null) return Future<bool>.value(false);
     if (node.children.length < 2) return Future<bool>.value(false);
@@ -174,7 +187,6 @@ mixin _BackButtonBucketNavigatorStateMixin on State<BucketNavigator> {
 
   @override
   void initState() {
-    // TODO(plugfox): check priority for nested navigators
     dispatcher?.removeCallback(_onBackButtonPressed);
     final rootBackDispatcher = context.octopus.config.backButtonDispatcher;
     dispatcher = rootBackDispatcher.createChildBackButtonDispatcher()

lib/src/widget/tabs.dart

@@ -0,0 +1 @@
+// TODO(plugfox): implement tabs with internal navigators