前端【免费下载链接】getxOpen screens/snackbars/dialogs/bottomSheets without context, manage states and inject dependencies easily with Get.项目地址https://gitcode.com/gh_mirrors/ge/getx点击查看免费下载本文是围绕 GetX 官方路由管理文档 展开的深度技术指南覆盖 GetX 状态管理框架中最核心的路由体系如何在不持有 BuildContext 的情况下完成页面跳转、如何通过GetMaterialAppGetPage构建命名路由表、如何像 Web 一样传递 query 与路径参数以及如何用routingCallback/GetObserver/GetMiddleware拦截并响应路由事件。读完本文你将掌握一套可完全脱离 FlutterNavigator.of(context)的声明式导航方案并理解其底层实现路由匹配、参数解析、观察者回调的工作方式。一、环境准备引入 Get 并启用 GetMaterialApp路由、SnackBar、Dialog、BottomSheet 之所以能脱离 context 工作前提是应用根组件由GetMaterialApp接管。在 pubspec.yaml 中加入依赖dependencies: get: ^4.6.6 # 以 pub 上实际发布版本为准然后只需把根组件从MaterialApp换成GetMaterialApp所有高级 API无 context 导航、SnackBar、Dialog、BottomSheet即可生效GetMaterialApp( // Before: MaterialApp( home: MyHome(), )从源码看GetMaterialApp内部实际上把配置转发给GetRoot再由GetRoot构建一个基于MaterialApp.router的GetDelegate路由器见 get_material_app.dart。这解释了为什么GetMaterialApp支持initialRoute、getPages、unknownRoute、routingCallback、defaultTransition、transitionDuration、smartManagement、binds等扩展参数——它们最终都进入了GetRoot的ConfigData驱动路由表的注册与匹配。二、无命名路由导航五组高频 API不依赖路由表、直接传入页面组件即可跳转这是 GetX 最简单的导航方式// 跳转到新页面 Get.to(NextScreen()); // 关闭当前页面等价于 Navigator.pop(context) Get.back(); // 跳转到新页面但无法返回上一页适合 SplashScreen、登录页 Get.off(NextScreen()); // 跳转到新页面并清空之前的所有路由适合购物车、投票、测试场景 Get.offAll(NextScreen());2.1 返回时传递结果数据Get.to()会返回一个FutureT?因此可以在跳转后等待并接收返回值var data await Get.to(Payment());在目标页面关闭时回传数据Get.back(result: success);回到原页面后消费结果if (data success) madeAnything();在源码层面这一机制由 get_router_delegate.dart 的_popWithResult实现每个GetPage内部持有一个CompleterT?pop时通过completer.complete(result)将结果回传给等待中的Future。对应地extension_navigation.dart 中的Get.back()支持result、canPop、times、id四个参数其中times 1时会退化为按次数连续 pop。2.2 零成本切换navigator 小写 API如果不想记 Get 的语法只需把 Flutter 的Navigator大写换成navigator小写即可在无 context 的情况下调用全部标准导航方法// 默认 Flutter 写法 Navigator.of(context).push( context, MaterialPageRoute( builder: (BuildContext context) { return HomePage(); }, ), ); // Get 提供的 Flutter 兼容写法无需 context navigator.push( MaterialPageRoute( builder: (_) { return HomePage(); }, ), ); // Get 原生语法更简洁 Get.to(HomePage());这一全局navigator的实现在 extension_navigation.dart 顶部NavigatorState? get navigator GetNavigationExt(Get).key.currentState;本质是把Get.key对应的NavigatorState暴露出来。2.3 常见 API 参数一览源码确认以Get.to()为例其完整签名见 extension_navigation.dart支持以下参数多数场景可直接使用参数类型默认值说明transitionTransition?Get.defaultTransition页面转场动画curveCurve?Get.defaultTransitionCurve动画曲线durationDuration?Get.defaultTransitionDuration转场时长idString?null嵌套导航的目标栈 idfullscreenDialogboolfalse以全屏对话框形式呈现argumentsdynamicnull传给目标页面的任意类型参数bindingsListBindingsInterfaceconst []页面绑定的依赖注入preventDuplicatesbooltrue是否阻止重复压入同一路由popGesturebool?Get.defaultPopGestureiOS 侧滑返回手势gestureWidthdouble Function(BuildContext)?null手势触发宽度其中Transition枚举定义在 transitions_type.dart包含fade、fadeIn、rightToLeft、leftToRight、upToDown、downToUp、rightToLeftWithFade、leftToRightWithFade、zoom、topLevel、noTransition、cupertino、cupertinoDialog、size、circularReveal、native共 16 种可选值。三、命名路由导航getPages 路由表当项目页面较多时建议采用命名路由。GetX 支持三种跳转方式// 跳转到下一个页面 Get.toNamed(/NextScreen); // 跳转并移除当前页面替换 Get.offNamed(/NextScreen); // 跳转并移除栈中所有之前的页面 Get.offAllNamed(/NextScreen);3.1 定义路由表命名路由通过GetMaterialApp.getPages注册每个条目是一个GetPagevoid main() { runApp( GetMaterialApp( initialRoute: /, getPages: [ GetPage(name: /, page: () MyHomePage()), GetPage(name: /second, page: () Second()), GetPage( name: /third, page: () Third(), transition: Transition.zoom ), ], ) ); }GetPage的完整构造参数见 get_route.dart除name和page外还支持transition、curve、transitionDuration、popGesture、binding/bindings/binds依赖注入、middlewares路由中间件、children子路由、unknownRoute子路由的 404、maintainState、opaque、fullscreenDialog、preventDuplicates、showCupertinoParallax等。需要注意两点约束路由名必须以/开头源码中有显式断言assert(name.startsWith(/), It is necessary to start route name [$name] with a slash)get_route.dart路由名会被_nameToRegex编译为正则表达式用于路径参数匹配详见本文动态 URL 一节。3.2 未定义路由404跳转到未注册的路由时会命中unknownRoute可以自定义 404 页面void main() { runApp( GetMaterialApp( unknownRoute: GetPage(name: /notfound, page: () UnknownRoutePage()), initialRoute: /, getPages: [ GetPage(name: /, page: () MyHomePage()), GetPage(name: /second, page: () Second()), ], ) ); }底层逻辑位于 get_router_delegate.dart 的toNamed当_getRouteDecoder无法在路由树中匹配到路由时返回 null随即调用goToUnknownPage()跳转到unknownRoute。这一行为在测试 get_main_test.dart 中有直接验证向未注册的/secondd跳转后断言当前路由变为/404。3.3 真实项目中的路由表组织仓库的 example_nav2/lib/app/routes/app_pages.dart 展示了生产级组织方式用Routes常量类集中管理路径字符串part app_routes.dart用AppPages.routes统一注册带bindings、middlewares、transition、children的嵌套路由表。这种做法把路由配置、依赖注入、权限校验集中在一处便于维护和测试。四、向命名路由传参arguments 与 Get.argumentsGet.toNamed()的arguments参数接受任意类型——字符串、Map、List 甚至类实例Get.toNamed(/NextScreen, arguments: Get is the best);在目标页面的类或 Controller 中读取print(Get.arguments); //print out: Get is the best从源码看arguments最终通过PageSettings进入路由解码器_buildPageSettings(page, arguments)会生成携带数据的PageSettings并在_configureRouterDecoder中通过copyWith(arguments: arguments)挂到GetPage上见 get_router_delegate.dart。五、动态 URL 链接Web 风格的参数传递这是 GetX 路由最具特色的能力命名路由可以携带完整的 URL 语义在 Web 端编译后路由会直接体现在浏览器地址栏中。5.1 Query 参数?keyvalueGet.offAllNamed(/NextScreen?devicephoneid354nameEnzo);在目标页面的 Controller / Bloc / 组件中读取print(Get.parameters[id]); // out: 354 print(Get.parameters[name]); // out: Enzo5.2 路径参数/profile/:user在路由表中用冒号声明路径参数。GetPage构造时会调用_nameToRegex把:user编译成正则捕获组见 get_route.dart因此:user这样的路径段可以按名取值。注意文档中的注释提示若同一路径既有无参数版本又有带参版本无参数的路由名必须以/结尾以便区分void main() { runApp( GetMaterialApp( initialRoute: /, getPages: [ GetPage( name: /, page: () MyHomePage(), ), GetPage( name: /profile/, page: () MyProfile(), ), // 带参数的路由/profile/:user GetPage( name: /profile/:user, page: () UserProfile(), ), GetPage( name: /third, page: () Third(), transition: Transition.cupertino ), ], ) ); }跳转并传参Get.toNamed(/profile/34954);目标页面取参print(Get.parameters[user]); // out: 349545.3 混合传递路径参数 query 参数既可以在 URL 字符串中直接拼接也可以通过parametersMap 显式传递两者等价Get.toNamed(/profile/34954?flagtruecountryitaly);var parameters String, String{flag: true,country: italy,}; Get.toNamed(/profile/34954, parameters: parameters);目标页面统一读取print(Get.parameters[user]); print(Get.parameters[flag]); print(Get.parameters[country]); // out: 34954 true italy从源码看Get.toNamed()收到非空parameters时会用Uri(path: page, queryParameters: parameters).toString()把 Map 序列化成 query 字符串拼接到路径上见 extension_navigation.dart而路径参数与 query 参数最终在_configureRouterDecoder中被合并进Get.parameters见 get_router_delegate.dart。六、路由监听与中间件6.1 routingCallback全局路由事件回调如果你使用GetMaterialApp最简单的方式是传入routingCallback监听每次路由变化并触发动作GetMaterialApp( routingCallback: (routing) { if(routing.current /second){ openAds(); } } )routingCallback的底层载体是GetObserver继承自NavigatorObserver。GetRoot会把routingCallback包装进GetObserver并挂到navigatorObservers上见 get_root.dart。6.2 不使用 GetMaterialApp 时的手动接入如果项目仍使用原生MaterialApp可以手动挂载GetObserver作为导航观察者void main() { runApp( MaterialApp( onGenerateRoute: Router.generateRoute, initialRoute: /, navigatorKey: Get.key, navigatorObservers: [ GetObserver(MiddleWare.observer), // HERE !!! ], ), ); }此时需要自行编写一个观察者类class MiddleWare { static observer(Routing routing) { /// 除了路由还可以监听每个页面的 snackbars、dialogs 和 bottomsheets。 /// 如果需要直接处理这三种事件必须显式判断事件类型 ! 你正在处理的目标。 if (routing.current /second !routing.isSnackbar) { Get.snackbar(Hi, You are on second route); } else if (routing.current /third){ print(last route called); } } }Routing对象在 route_observer.dart 中定义包含current当前路由名、previous上一个路由名、args路由参数、removed被移除的路由名、route当前 Route 对象、isBack、isBottomSheet、isDialog等字段。GetObserver重写了didPush、didPop、didRemove、didReplace四个回调分别对应压栈、出栈、移除、替换事件并在每次事件后调用你传入的回调函数。由于 SnackBar / Dialog / BottomSheet 也是以路由形式压栈的回调中可以用isSnackbar、isDialog、isBottomSheet标志区分事件来源——这正是文档注释里必须指定事件 ! 你正在处理的目标的原因。6.3 GetMiddleware声明式页面级中间件除了全局观察者GetPage还支持更精细的middlewares。抽象类GetMiddleware定义在 route_middleware.dart回调按固定顺序执行redirect→onPageCalled→onBindingsStart→onPageBuildStart→onPageBuilt→onPageDispose核心方法redirect(String? route)返回新的RouteSettings即重定向返回 null 则不重定向经典用法是登录守卫redirectDelegate(RouteDecoder route)Router API 版本的重定向返回 null 会停止本次导航onPageCalled(GetPage? page)页面被调用前修改页面配置如动态标题onBindingsStart/onPageBuildStart/onPageBuilt分别拦截依赖注入、页面构建前、构建后的阶段onPageDispose()页面销毁时清理priority多个中间件的执行优先级数值小的先执行-8 2 4 5。MiddlewareRunner按 priority 排序后逐个执行这些回调route_middleware.dart。仓库示例 auth_middleware.dart 给出了真实的登录守卫实现EnsureAuthMiddleware在redirectDelegate中检查登录态未登录则通过RouteDecoder.fromRoute重定向到登录页EnsureNotAuthedMiddleware在已登录时返回 null 阻止进入登录页。二者分别挂在 app_pages.dart 的/profile、/productDetails与/login路由上形成完整的权限闭环。七、无 context 的 SnackBar、Dialog 与 BottomSheet7.1 SnackBar传统 Flutter 必须持有 Scaffold 的 context 或 GlobalKey 才能弹出 SnackBarfinal snackBar SnackBar( content: Text(Hi!), action: SnackBarAction( label: I am a old and ugly snackbar :(, onPressed: (){} ), ); // Find the Scaffold in the widget tree and use // it to show a SnackBar. Scaffold.of(context).showSnackBar(snackBar);GetX 一行搞定Get.snackbar(Hi, i am a modern snackbar);而且可以在代码任何位置调用并支持丰富的自定义项Get.snackbar( Hey im a Get SnackBar!, // title Its unbelievable! Im using SnackBar without context, without boilerplate, without Scaffold, it is something truly amazing!, // message icon: Icon(Icons.alarm), shouldIconPulse: true, onTap:(){}, barBlur: 20, isDismissible: true, duration: Duration(seconds: 3), );Get.snackbar的完整可配置项以源码 extension_navigation.dart 的实际签名为准colorText文字颜色duration显示时长默认 3 秒instantInit为 false 时可在initState中调用通过Engine.instance.addPostFrameCallback延后到首帧后弹出snackPositionSnackPosition.top/SnackPosition.bottom默认 toptitleText/messageText自定义标题与消息 Widgeticon/shouldIconPulse图标及其脉冲动画maxWidth、margin、padding、borderRadius、borderColor、borderWidth外观尺寸backgroundColor、backgroundGradient、leftBarIndicatorColor、boxShadows背景与阴影mainButton、onTap、onHover交互回调isDismissible、dismissDirection滑动关闭showProgressIndicator、progressIndicatorController、progressIndicatorBackgroundColor、progressIndicatorValueColor进度条snackStyleSnackStyle.floating悬浮或固定forwardAnimationCurve/reverseAnimationCurve/animationDuration进出场动画barBlur、overlayBlur、overlayColor毛玻璃与遮罩userInputForm内嵌表单。如果需要完全掌控样式例如只有一行内容、不想强制 title message可退到底层原始 APIGet.rawSnackbar();它返回SnackbarControllerGet.snackbar正是在其上封装而来见 extension_navigation.dart。7.2 Dialog// 自定义对话框 Get.dialog(YourDialogWidget()); // 默认风格对话框 Get.defaultDialog( onConfirm: () print(Ok), middleText: Dialog made in 3 lines of code );Get.defaultDialog支持title、titleStyle、middleText、content、onConfirm、onCancel、onCustom、textConfirm、textCancel、confirm、cancel、custom、backgroundColor、radius、barrierDismissible、actions、onWillPop等参数内部基于AlertDialog组装见 extension_navigation.dart。需要showGeneralDialog的等价物时使用Get.generalDialog其他基于Overlay的 Flutter 对话框含 Cupertino 风格可以把Get.overlayContext当作 context 传入任意位置打开不基于Overlay的组件则使用Get.context。这两个 context 在 99% 的场景下可以替代 UI 中的 context唯一例外是未携带导航上下文使用InheritedWidget的情况。源码实现见 extension_navigation.dartGet.context直接取key.currentContext而Get.overlayContext通过遍历NavigatorState.overlay的子元素取得 Overlay 上下文因此总能拿到根导航器之上的 context。7.3 BottomSheetGet.bottomSheet等价于showModalBottomSheet但无需 contextGet.bottomSheet( Container( child: Wrap( children: Widget[ ListTile( leading: Icon(Icons.music_note), title: Text(Music), onTap: () {} ), ListTile( leading: Icon(Icons.videocam), title: Text(Video), onTap: () {}, ), ], ), ) );其实现位于 extension_navigation.dart底层是GetModalBottomSheetRoute通过Navigator.of(overlayContext!).push(...)弹出并支持backgroundColor、elevation、shape、barrierColor、isScrollControlled、isDismissible、enableDrag、enterBottomSheetDuration、exitBottomSheetDuration、curve等参数。三个无 context 弹层 API 都可以用Get.back()关闭。八、嵌套导航按 id 管理多个导航栈GetX 让 Flutter 的嵌套导航变得简单不需要 context通过id即可定位到指定导航栈。⚠️ 注意创建并行的导航栈有一定风险。理想情况下不建议使用 NestedNavigator或应谨慎使用。若项目确实需要请记住同时在内存中维护多个导航栈对 RAM 消耗可能不友好。用法如下先用Get.nestedKey(1)为嵌套的Navigator创建独立 key再通过Get.toNamed(/second, id: 1)指定导航栈Navigator( key: Get.nestedKey(1), // create a key by index initialRoute: /, onGenerateRoute: (settings) { if (settings.name /) { return GetPageRoute( page: () Scaffold( appBar: AppBar( title: Text(Main), ), body: Center( child: TextButton( color: Colors.blue, onPressed: () { Get.toNamed(/second, id:1); // navigate by your nested route by index }, child: Text(Go to second), ), ), ), ); } else if (settings.name /second) { return GetPageRoute( page: () Center( child: Scaffold( appBar: AppBar( title: Text(Main), ), body: Center( child: Text(second) ), ), ), ); } } ),底层实现见 get_root.dartGetRoot维护一个MapString, GetDelegate keysnestedKey(id)首次调用时为该 id 创建独立的GetDelegate含独立的路由树与 Navigator key后续调用直接复用所有id参数最终都通过searchDelegate(id)路由到对应的GetDelegate执行跳转见 extension_navigation.dart。因此同一套Get.to/Get.toNamed/Get.back等 API只需追加id参数即可操作任意嵌套栈。九、从测试用例看路由行为契约仓库测试 test/navigation/get_main_test.dart 为本文涉及的 API 提供了行为契约可作为验证依据Get.to/Get.off跳转后目标页面出现在组件树Get.off后Get.back()无法回到上一页get_main_test.dartGet.offAll清空全部历史栈连续两次Get.back()均无旧页面残留get_main_test.dartGet.toNamed/Get.offNamed命名路由跳转与替换行为get_main_test.dartGet.offNamedUntil按 predicate 弹出不满足条件的路由并保留匹配的路由get_main_test.dartunknownRoute未注册路由命中 404 页面get_main_test.dart各Transition枚举值均有冒烟测试覆盖get_main_test.dart。如需在本地运行这些测试可在仓库根目录执行flutter test test/navigation/get_main_test.dart。十、总结GetX 的路由管理把导航从 UI 层解耦出来GetMaterialApp提供全局路由表与观察者体系Get.to系列 API 与Get.toNamed系列 API 覆盖匿名与命名两种导航模式arguments与Get.parameters支持任意类型参数和 Web 风格 URLquery 路径参数routingCallback、GetObserver、GetMiddleware三层机制分别对应全局回调、原生观察者与页面级守卫。配合Get.snackbar/Get.dialog/Get.bottomSheet与嵌套导航id机制业务代码Controller、Service、BLoC可以在完全不持有 BuildContext 的情况下完成绝大多数交互。若需进一步研究状态管理与依赖注入的配合方式可继续阅读仓库内 state_management.md 与 dependency_management.md并结合 example_nav2 完整示例工程进行实践。赞分享前端【免费下载链接】getxOpen screens/snackbars/dialogs/bottomSheets without context, manage states and inject dependencies easily with Get.项目地址https://gitcode.com/gh_mirrors/ge/getx点击查看免费下载相关推荐GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与中间件GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与中间件 本文是围绕 GetX当前仓库 gh_mirrors/ge/getx h前端GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航 GetXGet是 Flutter 生态中一套集路由管理、状态管理与前端GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航 本指南以 documentation/es_ES/route_mana前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
前端【免费下载链接】getxOpen screens/snackbars/dialogs/bottomSheets without context, manage states and inject dependencies easily with Get.项目地址https://gitcode.com/gh_mirrors/ge/getx点击查看免费下载本文是围绕 GetX 官方路由管理文档 展开的深度技术指南覆盖 GetX 状态管理框架中最核心的路由体系如何在不持有 BuildContext 的情况下完成页面跳转、如何通过GetMaterialAppGetPage构建命名路由表、如何像 Web 一样传递 query 与路径参数以及如何用routingCallback/GetObserver/GetMiddleware拦截并响应路由事件。读完本文你将掌握一套可完全脱离 FlutterNavigator.of(context)的声明式导航方案并理解其底层实现路由匹配、参数解析、观察者回调的工作方式。一、环境准备引入 Get 并启用 GetMaterialApp路由、SnackBar、Dialog、BottomSheet 之所以能脱离 context 工作前提是应用根组件由GetMaterialApp接管。在 pubspec.yaml 中加入依赖dependencies: get: ^4.6.6 # 以 pub 上实际发布版本为准然后只需把根组件从MaterialApp换成GetMaterialApp所有高级 API无 context 导航、SnackBar、Dialog、BottomSheet即可生效GetMaterialApp( // Before: MaterialApp( home: MyHome(), )从源码看GetMaterialApp内部实际上把配置转发给GetRoot再由GetRoot构建一个基于MaterialApp.router的GetDelegate路由器见 get_material_app.dart。这解释了为什么GetMaterialApp支持initialRoute、getPages、unknownRoute、routingCallback、defaultTransition、transitionDuration、smartManagement、binds等扩展参数——它们最终都进入了GetRoot的ConfigData驱动路由表的注册与匹配。二、无命名路由导航五组高频 API不依赖路由表、直接传入页面组件即可跳转这是 GetX 最简单的导航方式// 跳转到新页面 Get.to(NextScreen()); // 关闭当前页面等价于 Navigator.pop(context) Get.back(); // 跳转到新页面但无法返回上一页适合 SplashScreen、登录页 Get.off(NextScreen()); // 跳转到新页面并清空之前的所有路由适合购物车、投票、测试场景 Get.offAll(NextScreen());2.1 返回时传递结果数据Get.to()会返回一个FutureT?因此可以在跳转后等待并接收返回值var data await Get.to(Payment());在目标页面关闭时回传数据Get.back(result: success);回到原页面后消费结果if (data success) madeAnything();在源码层面这一机制由 get_router_delegate.dart 的_popWithResult实现每个GetPage内部持有一个CompleterT?pop时通过completer.complete(result)将结果回传给等待中的Future。对应地extension_navigation.dart 中的Get.back()支持result、canPop、times、id四个参数其中times 1时会退化为按次数连续 pop。2.2 零成本切换navigator 小写 API如果不想记 Get 的语法只需把 Flutter 的Navigator大写换成navigator小写即可在无 context 的情况下调用全部标准导航方法// 默认 Flutter 写法 Navigator.of(context).push( context, MaterialPageRoute( builder: (BuildContext context) { return HomePage(); }, ), ); // Get 提供的 Flutter 兼容写法无需 context navigator.push( MaterialPageRoute( builder: (_) { return HomePage(); }, ), ); // Get 原生语法更简洁 Get.to(HomePage());这一全局navigator的实现在 extension_navigation.dart 顶部NavigatorState? get navigator GetNavigationExt(Get).key.currentState;本质是把Get.key对应的NavigatorState暴露出来。2.3 常见 API 参数一览源码确认以Get.to()为例其完整签名见 extension_navigation.dart支持以下参数多数场景可直接使用参数类型默认值说明transitionTransition?Get.defaultTransition页面转场动画curveCurve?Get.defaultTransitionCurve动画曲线durationDuration?Get.defaultTransitionDuration转场时长idString?null嵌套导航的目标栈 idfullscreenDialogboolfalse以全屏对话框形式呈现argumentsdynamicnull传给目标页面的任意类型参数bindingsListBindingsInterfaceconst []页面绑定的依赖注入preventDuplicatesbooltrue是否阻止重复压入同一路由popGesturebool?Get.defaultPopGestureiOS 侧滑返回手势gestureWidthdouble Function(BuildContext)?null手势触发宽度其中Transition枚举定义在 transitions_type.dart包含fade、fadeIn、rightToLeft、leftToRight、upToDown、downToUp、rightToLeftWithFade、leftToRightWithFade、zoom、topLevel、noTransition、cupertino、cupertinoDialog、size、circularReveal、native共 16 种可选值。三、命名路由导航getPages 路由表当项目页面较多时建议采用命名路由。GetX 支持三种跳转方式// 跳转到下一个页面 Get.toNamed(/NextScreen); // 跳转并移除当前页面替换 Get.offNamed(/NextScreen); // 跳转并移除栈中所有之前的页面 Get.offAllNamed(/NextScreen);3.1 定义路由表命名路由通过GetMaterialApp.getPages注册每个条目是一个GetPagevoid main() { runApp( GetMaterialApp( initialRoute: /, getPages: [ GetPage(name: /, page: () MyHomePage()), GetPage(name: /second, page: () Second()), GetPage( name: /third, page: () Third(), transition: Transition.zoom ), ], ) ); }GetPage的完整构造参数见 get_route.dart除name和page外还支持transition、curve、transitionDuration、popGesture、binding/bindings/binds依赖注入、middlewares路由中间件、children子路由、unknownRoute子路由的 404、maintainState、opaque、fullscreenDialog、preventDuplicates、showCupertinoParallax等。需要注意两点约束路由名必须以/开头源码中有显式断言assert(name.startsWith(/), It is necessary to start route name [$name] with a slash)get_route.dart路由名会被_nameToRegex编译为正则表达式用于路径参数匹配详见本文动态 URL 一节。3.2 未定义路由404跳转到未注册的路由时会命中unknownRoute可以自定义 404 页面void main() { runApp( GetMaterialApp( unknownRoute: GetPage(name: /notfound, page: () UnknownRoutePage()), initialRoute: /, getPages: [ GetPage(name: /, page: () MyHomePage()), GetPage(name: /second, page: () Second()), ], ) ); }底层逻辑位于 get_router_delegate.dart 的toNamed当_getRouteDecoder无法在路由树中匹配到路由时返回 null随即调用goToUnknownPage()跳转到unknownRoute。这一行为在测试 get_main_test.dart 中有直接验证向未注册的/secondd跳转后断言当前路由变为/404。3.3 真实项目中的路由表组织仓库的 example_nav2/lib/app/routes/app_pages.dart 展示了生产级组织方式用Routes常量类集中管理路径字符串part app_routes.dart用AppPages.routes统一注册带bindings、middlewares、transition、children的嵌套路由表。这种做法把路由配置、依赖注入、权限校验集中在一处便于维护和测试。四、向命名路由传参arguments 与 Get.argumentsGet.toNamed()的arguments参数接受任意类型——字符串、Map、List 甚至类实例Get.toNamed(/NextScreen, arguments: Get is the best);在目标页面的类或 Controller 中读取print(Get.arguments); //print out: Get is the best从源码看arguments最终通过PageSettings进入路由解码器_buildPageSettings(page, arguments)会生成携带数据的PageSettings并在_configureRouterDecoder中通过copyWith(arguments: arguments)挂到GetPage上见 get_router_delegate.dart。五、动态 URL 链接Web 风格的参数传递这是 GetX 路由最具特色的能力命名路由可以携带完整的 URL 语义在 Web 端编译后路由会直接体现在浏览器地址栏中。5.1 Query 参数?keyvalueGet.offAllNamed(/NextScreen?devicephoneid354nameEnzo);在目标页面的 Controller / Bloc / 组件中读取print(Get.parameters[id]); // out: 354 print(Get.parameters[name]); // out: Enzo5.2 路径参数/profile/:user在路由表中用冒号声明路径参数。GetPage构造时会调用_nameToRegex把:user编译成正则捕获组见 get_route.dart因此:user这样的路径段可以按名取值。注意文档中的注释提示若同一路径既有无参数版本又有带参版本无参数的路由名必须以/结尾以便区分void main() { runApp( GetMaterialApp( initialRoute: /, getPages: [ GetPage( name: /, page: () MyHomePage(), ), GetPage( name: /profile/, page: () MyProfile(), ), // 带参数的路由/profile/:user GetPage( name: /profile/:user, page: () UserProfile(), ), GetPage( name: /third, page: () Third(), transition: Transition.cupertino ), ], ) ); }跳转并传参Get.toNamed(/profile/34954);目标页面取参print(Get.parameters[user]); // out: 349545.3 混合传递路径参数 query 参数既可以在 URL 字符串中直接拼接也可以通过parametersMap 显式传递两者等价Get.toNamed(/profile/34954?flagtruecountryitaly);var parameters String, String{flag: true,country: italy,}; Get.toNamed(/profile/34954, parameters: parameters);目标页面统一读取print(Get.parameters[user]); print(Get.parameters[flag]); print(Get.parameters[country]); // out: 34954 true italy从源码看Get.toNamed()收到非空parameters时会用Uri(path: page, queryParameters: parameters).toString()把 Map 序列化成 query 字符串拼接到路径上见 extension_navigation.dart而路径参数与 query 参数最终在_configureRouterDecoder中被合并进Get.parameters见 get_router_delegate.dart。六、路由监听与中间件6.1 routingCallback全局路由事件回调如果你使用GetMaterialApp最简单的方式是传入routingCallback监听每次路由变化并触发动作GetMaterialApp( routingCallback: (routing) { if(routing.current /second){ openAds(); } } )routingCallback的底层载体是GetObserver继承自NavigatorObserver。GetRoot会把routingCallback包装进GetObserver并挂到navigatorObservers上见 get_root.dart。6.2 不使用 GetMaterialApp 时的手动接入如果项目仍使用原生MaterialApp可以手动挂载GetObserver作为导航观察者void main() { runApp( MaterialApp( onGenerateRoute: Router.generateRoute, initialRoute: /, navigatorKey: Get.key, navigatorObservers: [ GetObserver(MiddleWare.observer), // HERE !!! ], ), ); }此时需要自行编写一个观察者类class MiddleWare { static observer(Routing routing) { /// 除了路由还可以监听每个页面的 snackbars、dialogs 和 bottomsheets。 /// 如果需要直接处理这三种事件必须显式判断事件类型 ! 你正在处理的目标。 if (routing.current /second !routing.isSnackbar) { Get.snackbar(Hi, You are on second route); } else if (routing.current /third){ print(last route called); } } }Routing对象在 route_observer.dart 中定义包含current当前路由名、previous上一个路由名、args路由参数、removed被移除的路由名、route当前 Route 对象、isBack、isBottomSheet、isDialog等字段。GetObserver重写了didPush、didPop、didRemove、didReplace四个回调分别对应压栈、出栈、移除、替换事件并在每次事件后调用你传入的回调函数。由于 SnackBar / Dialog / BottomSheet 也是以路由形式压栈的回调中可以用isSnackbar、isDialog、isBottomSheet标志区分事件来源——这正是文档注释里必须指定事件 ! 你正在处理的目标的原因。6.3 GetMiddleware声明式页面级中间件除了全局观察者GetPage还支持更精细的middlewares。抽象类GetMiddleware定义在 route_middleware.dart回调按固定顺序执行redirect→onPageCalled→onBindingsStart→onPageBuildStart→onPageBuilt→onPageDispose核心方法redirect(String? route)返回新的RouteSettings即重定向返回 null 则不重定向经典用法是登录守卫redirectDelegate(RouteDecoder route)Router API 版本的重定向返回 null 会停止本次导航onPageCalled(GetPage? page)页面被调用前修改页面配置如动态标题onBindingsStart/onPageBuildStart/onPageBuilt分别拦截依赖注入、页面构建前、构建后的阶段onPageDispose()页面销毁时清理priority多个中间件的执行优先级数值小的先执行-8 2 4 5。MiddlewareRunner按 priority 排序后逐个执行这些回调route_middleware.dart。仓库示例 auth_middleware.dart 给出了真实的登录守卫实现EnsureAuthMiddleware在redirectDelegate中检查登录态未登录则通过RouteDecoder.fromRoute重定向到登录页EnsureNotAuthedMiddleware在已登录时返回 null 阻止进入登录页。二者分别挂在 app_pages.dart 的/profile、/productDetails与/login路由上形成完整的权限闭环。七、无 context 的 SnackBar、Dialog 与 BottomSheet7.1 SnackBar传统 Flutter 必须持有 Scaffold 的 context 或 GlobalKey 才能弹出 SnackBarfinal snackBar SnackBar( content: Text(Hi!), action: SnackBarAction( label: I am a old and ugly snackbar :(, onPressed: (){} ), ); // Find the Scaffold in the widget tree and use // it to show a SnackBar. Scaffold.of(context).showSnackBar(snackBar);GetX 一行搞定Get.snackbar(Hi, i am a modern snackbar);而且可以在代码任何位置调用并支持丰富的自定义项Get.snackbar( Hey im a Get SnackBar!, // title Its unbelievable! Im using SnackBar without context, without boilerplate, without Scaffold, it is something truly amazing!, // message icon: Icon(Icons.alarm), shouldIconPulse: true, onTap:(){}, barBlur: 20, isDismissible: true, duration: Duration(seconds: 3), );Get.snackbar的完整可配置项以源码 extension_navigation.dart 的实际签名为准colorText文字颜色duration显示时长默认 3 秒instantInit为 false 时可在initState中调用通过Engine.instance.addPostFrameCallback延后到首帧后弹出snackPositionSnackPosition.top/SnackPosition.bottom默认 toptitleText/messageText自定义标题与消息 Widgeticon/shouldIconPulse图标及其脉冲动画maxWidth、margin、padding、borderRadius、borderColor、borderWidth外观尺寸backgroundColor、backgroundGradient、leftBarIndicatorColor、boxShadows背景与阴影mainButton、onTap、onHover交互回调isDismissible、dismissDirection滑动关闭showProgressIndicator、progressIndicatorController、progressIndicatorBackgroundColor、progressIndicatorValueColor进度条snackStyleSnackStyle.floating悬浮或固定forwardAnimationCurve/reverseAnimationCurve/animationDuration进出场动画barBlur、overlayBlur、overlayColor毛玻璃与遮罩userInputForm内嵌表单。如果需要完全掌控样式例如只有一行内容、不想强制 title message可退到底层原始 APIGet.rawSnackbar();它返回SnackbarControllerGet.snackbar正是在其上封装而来见 extension_navigation.dart。7.2 Dialog// 自定义对话框 Get.dialog(YourDialogWidget()); // 默认风格对话框 Get.defaultDialog( onConfirm: () print(Ok), middleText: Dialog made in 3 lines of code );Get.defaultDialog支持title、titleStyle、middleText、content、onConfirm、onCancel、onCustom、textConfirm、textCancel、confirm、cancel、custom、backgroundColor、radius、barrierDismissible、actions、onWillPop等参数内部基于AlertDialog组装见 extension_navigation.dart。需要showGeneralDialog的等价物时使用Get.generalDialog其他基于Overlay的 Flutter 对话框含 Cupertino 风格可以把Get.overlayContext当作 context 传入任意位置打开不基于Overlay的组件则使用Get.context。这两个 context 在 99% 的场景下可以替代 UI 中的 context唯一例外是未携带导航上下文使用InheritedWidget的情况。源码实现见 extension_navigation.dartGet.context直接取key.currentContext而Get.overlayContext通过遍历NavigatorState.overlay的子元素取得 Overlay 上下文因此总能拿到根导航器之上的 context。7.3 BottomSheetGet.bottomSheet等价于showModalBottomSheet但无需 contextGet.bottomSheet( Container( child: Wrap( children: Widget[ ListTile( leading: Icon(Icons.music_note), title: Text(Music), onTap: () {} ), ListTile( leading: Icon(Icons.videocam), title: Text(Video), onTap: () {}, ), ], ), ) );其实现位于 extension_navigation.dart底层是GetModalBottomSheetRoute通过Navigator.of(overlayContext!).push(...)弹出并支持backgroundColor、elevation、shape、barrierColor、isScrollControlled、isDismissible、enableDrag、enterBottomSheetDuration、exitBottomSheetDuration、curve等参数。三个无 context 弹层 API 都可以用Get.back()关闭。八、嵌套导航按 id 管理多个导航栈GetX 让 Flutter 的嵌套导航变得简单不需要 context通过id即可定位到指定导航栈。⚠️ 注意创建并行的导航栈有一定风险。理想情况下不建议使用 NestedNavigator或应谨慎使用。若项目确实需要请记住同时在内存中维护多个导航栈对 RAM 消耗可能不友好。用法如下先用Get.nestedKey(1)为嵌套的Navigator创建独立 key再通过Get.toNamed(/second, id: 1)指定导航栈Navigator( key: Get.nestedKey(1), // create a key by index initialRoute: /, onGenerateRoute: (settings) { if (settings.name /) { return GetPageRoute( page: () Scaffold( appBar: AppBar( title: Text(Main), ), body: Center( child: TextButton( color: Colors.blue, onPressed: () { Get.toNamed(/second, id:1); // navigate by your nested route by index }, child: Text(Go to second), ), ), ), ); } else if (settings.name /second) { return GetPageRoute( page: () Center( child: Scaffold( appBar: AppBar( title: Text(Main), ), body: Center( child: Text(second) ), ), ), ); } } ),底层实现见 get_root.dartGetRoot维护一个MapString, GetDelegate keysnestedKey(id)首次调用时为该 id 创建独立的GetDelegate含独立的路由树与 Navigator key后续调用直接复用所有id参数最终都通过searchDelegate(id)路由到对应的GetDelegate执行跳转见 extension_navigation.dart。因此同一套Get.to/Get.toNamed/Get.back等 API只需追加id参数即可操作任意嵌套栈。九、从测试用例看路由行为契约仓库测试 test/navigation/get_main_test.dart 为本文涉及的 API 提供了行为契约可作为验证依据Get.to/Get.off跳转后目标页面出现在组件树Get.off后Get.back()无法回到上一页get_main_test.dartGet.offAll清空全部历史栈连续两次Get.back()均无旧页面残留get_main_test.dartGet.toNamed/Get.offNamed命名路由跳转与替换行为get_main_test.dartGet.offNamedUntil按 predicate 弹出不满足条件的路由并保留匹配的路由get_main_test.dartunknownRoute未注册路由命中 404 页面get_main_test.dart各Transition枚举值均有冒烟测试覆盖get_main_test.dart。如需在本地运行这些测试可在仓库根目录执行flutter test test/navigation/get_main_test.dart。十、总结GetX 的路由管理把导航从 UI 层解耦出来GetMaterialApp提供全局路由表与观察者体系Get.to系列 API 与Get.toNamed系列 API 覆盖匿名与命名两种导航模式arguments与Get.parameters支持任意类型参数和 Web 风格 URLquery 路径参数routingCallback、GetObserver、GetMiddleware三层机制分别对应全局回调、原生观察者与页面级守卫。配合Get.snackbar/Get.dialog/Get.bottomSheet与嵌套导航id机制业务代码Controller、Service、BLoC可以在完全不持有 BuildContext 的情况下完成绝大多数交互。若需进一步研究状态管理与依赖注入的配合方式可继续阅读仓库内 state_management.md 与 dependency_management.md并结合 example_nav2 完整示例工程进行实践。赞分享前端【免费下载链接】getxOpen screens/snackbars/dialogs/bottomSheets without context, manage states and inject dependencies easily with Get.项目地址https://gitcode.com/gh_mirrors/ge/getx点击查看免费下载相关推荐GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与中间件GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与中间件 本文是围绕 GetX当前仓库 gh_mirrors/ge/getx h前端GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航 GetXGet是 Flutter 生态中一套集路由管理、状态管理与前端GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航GetX 路由管理完全指南无 Context 导航、命名路由、动态 URL 与嵌套导航 本指南以 documentation/es_ES/route_mana前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
