【鸿蒙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作为页面根容器，除了支持普通组件的通用属性外，还支持页面相关的属性，如：页面的生命周期，页面工具栏和标题栏，自定义页面转场动画，页面级窗口属性控制（横竖屏，系统状态栏，系统导航条）等能力。

整体导航架构图如下所示： 

 单双栏显示的结构图：