HarmonyOS鸿蒙Next中ArkUI路由/导航系列一：ArkUI路由原理简介，认识Navigation组件
HarmonyOS鸿蒙Next中ArkUI路由/导航系列一：ArkUI路由原理简介，认识Navigation组件
Navigation作为导航容器，主要用于实现页面间的路由跳转，Navigation导航既可以作为应用全局的导航容器，也可以作为局部的导航容器，如：在弹窗、模态等非全屏组件中使用。
1、Navigation（导航容器）
Navigation是路由导航的根视图容器，一般作为页面（@Entry修饰的自定义组件，定义为Router页面）的根容器（作为全局导航使用），包括单栏（Stack）、分栏（Split）和自适应（Auto）三种显示模式，Auto模式会基于Navigation组件的宽度自动在Stack（<600vp）和Split（>=600vp）中切换。
Navigation组件本身可不作为显示容器，只用于承载路由的相关功能，如绑定导航控制器对象，路由切换，分栏显示，自定义转场动画控制等。
Navigation组件主要包含导航栏（NavBar）和子页（NavDestination），子页通过栈结构管理（存在NavPathStack中）。导航栏又称Navbar（Navigation的子组件，直接挂载到Navigation上），可以通过hideNavBar属性进行隐藏（单栏应用推荐隐藏导航页），导航栏不存在页面栈中。子页面是一个以NavDestination为根节点的子树，通过@Builder构造出来，再通过NavPathStack提供的栈操作方法挂载到Navigation上显示，后续详细介绍。
2、NavPathStack（导航控制器）
Navigation的子页面栈存在NavPathStack中，每个Navigation都需要绑定一个NavPathStack对象，NavPathStack用于控制Navigation中所有子页的切换，NavPathStack提供了很多基础的路由切换方法，如：pushPath，pushDestination（带返回回调），pop，replacePath等，以及路由拦截，转场动画控制，路由栈信息获取等能力。NavPathStack也支持开发者继承并复写相关路由操作方法。 NavPathStack跟Navigation一一对应，在每个子页中可以通过NavDestination的onReady回调获取，也可以全局维护一个单例的NavPathStack，在任意地方获取并执行路由操作（注意：页面切换动画和布局必须在UI线程中才可以生效，依赖Vsync信号）
3、NavBar（导航栏）
我们把Navigation中直接加载的孩子节点称为导航栏（NavBar），单栏显示时它是整个导航的首页，分栏显示时它是固定的导航栏（默认显示在左边，也可以通过NavBarPosition属性控制），开发者可以通过hideNavBar去控制导航栏的显隐（推荐仅单栏显示的应用隐藏掉NavBar），也可以通过navBarWidth属性控制双栏显示下的Navbar宽度，NavBar本身不属于页面栈中的页面，不具备页面的生命周期等，不能通过NavPathStack的方法控制。 开发者可以通过onNavBarStateChange去感知导航栏的显隐，通过mode属性控制单双栏切换，也可以通过onNavigationModeChange去感知单双栏的切换。
4、NavDestination（子页容器）
Navigation子页面的根容器，每个子页面都需要包裹在一个NavDestination中，通过NavPathStack提供的栈操作方法（push，pop等）将子页面挂载导Navigation上显示或删除。 NavDestination作为页面根容器，除了支持普通组件的通用属性外，还支持页面相关的属性，如：页面的生命周期，页面工具栏和标题栏，自定义页面转场动画，页面级窗口属性控制（横竖屏，系统状态栏，系统导航条）等能力。
整体导航架构图如下所示：
单双栏显示的结构图：
下一章 【ArkUI路由/导航系列】二：Navigation基础路由操作，让页面跳转起来
【系列其他文章】
【ArkUI路由/导航系列】〇：ArkUI Navigation组件全面解析：从基础导航到高级路由的实践
【ArkUI路由/导航系列】一：ArkUI路由原理简介，认识Navigation组件
【ArkUI路由/导航系列】二：Navigation基础路由操作，让页面跳转起来
【ArkUI路由/导航系列】三：NavDestination标题栏和工具栏，丰富页面信息
【ArkUI路由/导航系列】四：Navigation页面信息查询
【ArkUI路由/导航系列】五：Navigation生命周期管理
【ArkUI路由/导航系列】六：Navigation组件的无感监听
【ArkUI路由/导航系列】七：Navigation自定义转场动画，让页面切换炫起来
【ArkUI路由/导航系列】八：Navigation跨包路由，迈入高级路由能力
【ArkUI路由/导航系列】九：Navigation分栏开发，开启多设备开发之旅
【ArkUI路由/导航系列】十：Navigation嵌套开发
【ArkUI路由/导航系列】十一：Navigation弹窗页面开发
【ArkUI路由/导航系列】十二：Navigation路由拦截
更多关于HarmonyOS鸿蒙Next中ArkUI路由/导航系列一：ArkUI路由原理简介，认识Navigation组件的实战教程也可以访问 https://www.itying.com/category-93-b0.html
在HarmonyOS鸿蒙Next中，Navigation是ArkUI的核心导航组件，基于堆栈管理路由页面。它通过页面栈机制实现层级导航，支持push/pop操作完成页面跳转与返回。Navigation组件包含NavigationStack作为容器，NavigationLink触发路由切换，NavigationDestination定义目标页。路由过程自动维护页面状态，保持UI一致性。该组件采用声明式语法，与ArkUI状态管理深度集成，开发者只需配置路由规则，无需手动处理页面生命周期。
更多关于HarmonyOS鸿蒙Next中ArkUI路由/导航系列一：ArkUI路由原理简介，认识Navigation组件的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
