HarmonyOS 中 Navigation 和 router是一回事吗?

在鸿蒙(HarmonyOS)中,Navigation 组件 并不是一种独立的路由机制,而是一个 UI 导航容器组件 ,用于构建具有导航功能的界面结构(如底部导航栏、侧边栏等)。它的主要职责是管理 同级页面或子组件的切换和布局 ,而非直接处理页面跳转逻辑。不过,开发者通常会结合 @ohos.router 模块和 Navigation 组件共同实现完整的导航功能。


  • 功能定位
    Navigation 是 ArkUI 提供的一个 布局容器组件 ,用于实现常见的导航模式(如 Tab 导航、抽屉导航等)。它通过 NavRouterNavDestination 管理子组件的切换。
  • 与路由的区别
    • 路由(@ohos.router:负责页面栈管理、跨页面跳转和参数传递(底层逻辑)。
    • Navigation 组件:负责导航栏的 UI 展示和交互(视觉层),需要与路由配合使用。

场景:实现底部 Tab 导航

typescript 复制代码
// main.ets
import router from '@ohos.router';

@Entry
@Component
struct NavigationExample {
  @State activeIndex: number = 0; // 当前选中的 Tab 索引

  build() {
    Navigation() {
      // 底部 Tab 栏
      NavDestination() {
        Column() {
          Text('首页').fontSize(20)
          Button('跳转到详情页')
            .onClick(() => {
              // 通过路由跳转到详情页
              router.pushUrl({ url: 'pages/DetailPage' });
            })
        }
        .width('100%')
        .height('100%')
      }
      .title('首页')
      .icon($r('app.media.home'))

      NavDestination() {
        Column() {
          Text('设置页').fontSize(20)
        }
        .width('100%')
        .height('100%')
      }
      .title('设置')
      .icon($r('app.media.settings'))
    }
    .title('导航示例')
    .mode(NavigationMode.Stack) // 堆栈模式
    .navBarPosition(NavigationPosition.Bottom) // 底部导航栏
    .onNavStateChange((index: number) => {
      // Tab 切换事件
      this.activeIndex = index;
    })
  }
}

代码解析

  1. Navigation 容器 :包裹所有导航页面(NavDestination)。
  2. NavDestination:定义每个 Tab 对应的内容和样式。
  3. 路由跳转 :在 Tab 页面内仍使用 router.pushUrl() 实现跨页面跳转。
  4. 导航模式
    • Stack:堆栈模式(默认),适合层级跳转。
    • Split:分屏模式(大屏设备适用)。

职责 Navigation 组件 路由(@ohos.router
页面跳转 不直接处理跳转,需调用 router API 通过 pushUrl/back 管理跳转
导航栏 UI 提供 Tab、标题栏等视觉元素 无 UI 元素
页面栈管理 不管理页面栈 维护页面栈(前进、后退)
参数传递 不支持直接传参 通过 params 传递 JSON 对象
适用场景 同级页面切换(如 Tab 导航) 跨层级页面跳转(如详情页、表单页)

4. 常见误区澄清

误区 1Navigation 可以替代路由

纠正

  • Navigation 仅负责 同级页面的布局和切换,无法处理跨层级跳转或页面栈管理。
  • 若需要跳转到其他层级的页面(如从首页跳转到详情页),仍需使用 router.pushUrl()

误区 2Navigation 自带路由功能

纠正

  • Navigation 的 Tab 切换本质上是组件显隐控制,而非真正的路由跳转。
  • 若需要页面生命周期管理(如 onPageShow/onPageHide),仍需依赖 @ohos.router

typescript 复制代码
// 在 Tab 页面内实现路由跳转
Button('跳转到独立页面')
  .onClick(() => {
    router.pushUrl({
      url: 'pages/IndependentPage',
      params: { from: 'Tab1' }
    });
  })

// 返回时处理路由
Button('返回')
  .onClick(() => {
    router.back();
  })

总结

  • Navigation 组件UI 导航容器,用于构建 Tab 栏、侧边栏等导航结构的界面。
  • 路由(@ohos.router底层跳转逻辑,负责页面栈管理和参数传递。
  • 二者需结合使用:Navigation 管理同级页面的布局,路由处理跨层级跳转。
相关推荐
zhanshuo13 小时前
构建可扩展的状态系统:基于 ArkTS 的模块化状态管理设计与实现
harmonyos
zhanshuo13 小时前
ArkTS 模块通信全解析:用事件总线实现页面消息联动
harmonyos
codefish79817 小时前
鸿蒙开发学习之路:从入门到实践的全面指南
harmonyos
yrjw1 天前
一款基于react-native harmonyOS 封装的【文档】文件预览查看开源库(基于Harmony 原生文件预览服务进行封装)
harmonyos
搜狐技术产品小编20232 天前
搜狐新闻直播间适配HarmonyOs实现点赞动画
华为·harmonyos
zhanshuo2 天前
ArkUI 玩转水平滑动视图:超全实战教程与项目应用解析
harmonyos·arkui
zhanshuo2 天前
ArkUI Canvas 实战:快速绘制柱状图图表组件
harmonyos·arkui
zhanshuo2 天前
手把手教你用 ArkUI 写出高性能分页列表:List + onScroll 实战解析
harmonyos
zhanshuo2 天前
深入解析 ArkUI 触摸事件机制:从点击到滑动的开发全流程
harmonyos
i仙银3 天前
鸿蒙沙箱浏览器 - SandboxFinder
app·harmonyos