Flutter Navigator 2.0下如何重写iOS侧滑返回功能？

Navigator 2.0里重写popRoute只能搞定Android返回键，iOS侧滑返回得从路由拦截或手势控制入手，下面是几种实用方案：

1. 自定义PageRoute接管侧滑手势 #

直接封装自定义的MaterialPageRoute或CupertinoPageRoute，把侧滑手势的控制权拿到自己手里：

class CustomPageRoute<T> extends MaterialPageRoute<T> {
  CustomPageRoute({required WidgetBuilder builder}) : super(builder: builder);

  @override
  Widget buildPage(BuildContext context, Animation<double> animation, Animation<double> secondaryAnimation) {
    // 监听左滑手势，达到阈值触发自定义逻辑
    return GestureDetector(
      onHorizontalDragUpdate: (details) {
        // 左滑距离超过20时触发
        if (details.delta.dx > 20) {
          _handleCustomPop(context);
        }
      },
      child: super.buildPage(context, animation, secondaryAnimation),
    );
  }

  void _handleCustomPop(BuildContext context) {
    // 这里放你的自定义逻辑，比如弹确认框
    showDialog(
      context: context,
      builder: (_) => AlertDialog(
        title: const Text('确定要返回吗？'),
        actions: [
          TextButton(
            onPressed: () => Navigator.of(context).pop(),
            child: const Text('取消'),
          ),
          TextButton(
            onPressed: () {
              Navigator.of(context).pop();
              // 更新Navigator 2.0的路由栈，示例：
              // (Router.of(context).routerDelegate as AppRouterDelegate)._pages.removeLast();
              // (Router.of(context).routerDelegate as AppRouterDelegate).notifyListeners();
            },
            child: const Text('确定'),
          ),
        ],
      ),
    );
  }
}

之后所有页面跳转都使用这个CustomPageRoute，就能拦截侧滑手势。

2. 在RouterDelegate的onPopPage里全局拦截 #

Navigator的onPopPage是所有pop请求的入口（包括iOS侧滑返回），直接在这里统一处理自定义逻辑：

class AppRouterDelegate extends RouterDelegate<AppRouteConfig>
    with ChangeNotifier, PopNavigatorRouterDelegateMixin<AppRouteConfig> {
  final GlobalKey<NavigatorState> navigatorKey = GlobalKey();
  final List<Page> _pages = [];

  @override
  Widget build(BuildContext context) {
    return Navigator(
      key: navigatorKey,
      pages: [..._pages],
      onPopPage: (route, result) {
        // 先阻止默认pop行为
        if (!route.didPop(result)) return false;

        // 弹确认框，用户确认后再更新路由栈
        showDialog(
          context: context,
          builder: (_) => AlertDialog(
            title: const Text('确认返回？'),
            actions: [
              TextButton(
                onPressed: () => Navigator.of(context).pop(),
                child: const Text('取消'),
              ),
              TextButton(
                onPressed: () {
                  Navigator.of(context).pop();
                  _pages.removeLast();
                  notifyListeners();
                },
                child: const Text('确定'),
              ),
            ],
          ),
        );
        return true;
      },
    );
  }

  // 其他RouterDelegate的必要实现（如setNewRoutePath、currentConfiguration等）...
}

这种方式不用修改每个页面的跳转代码，全局统一处理更省心。

3. 针对Cupertino风格路由的优化 #

如果使用CupertinoPageRoute，可以重写手势相关属性，动态控制侧滑权限或拦截手势：

class CustomCupertinoRoute<T> extends CupertinoPageRoute<T> {
  CustomCupertinoRoute({required WidgetBuilder builder}) : super(builder: builder);

  // 可根据业务逻辑动态返回true/false，控制是否允许侧滑
  @override
  bool get popGestureEnabled => true;

  @override
  Widget buildPage(BuildContext context, Animation<double> animation, Animation<double> secondaryAnimation) {
    return GestureDetector(
      // 监听侧滑结束速度，更贴近iOS原生侧滑触发逻辑
      onHorizontalDragEnd: (details) {
        if (details.primaryVelocity! > 100) {
          _handleCustomPop(context);
        }
      },
      child: super.buildPage(context, animation, secondaryAnimation),
    );
  }

  void _handleCustomPop(BuildContext context) {
    // 自定义返回逻辑示例
    showDialog(
      context: context,
      builder: (_) => AlertDialog(
        title: const Text('确定返回？'),
        actions: [
          TextButton(onPressed: () => Navigator.pop(context), child: const Text('取消')),
          TextButton(
            onPressed: () {
              Navigator.pop(context);
              Navigator.pop(context);
            },
            child: const Text('确定'),
          ),
        ],
      ),
    );
  }
}

关键注意事项 #

• 更新路由栈后必须调用notifyListeners()，否则Navigator 2.0不会刷新页面状态。
• 全局处理优先用onPopPage方案，无需修改页面跳转代码。
• 自定义手势时尽量贴近iOS原生逻辑（如滑动距离、速度阈值），避免影响用户体验。

内容的提问来源于stack exchange，提问作者fabienbranchel