入门版 鸿蒙 组件导航 (Navigation)

入门版 鸿蒙 组件导航 (Navigation)

注意:使用 DevEco Studio 运行本案例,要使用模拟器,千万不要用预览器,预览器看看 Navigation 布局还是可以的

  1. 效果:点击首页(Index)跳转到页面(MainPage)
  2. 先写 Index 和 MainPage 这两个页面
  3. 路由相关配置

Index 和 MainPage 两个页面,点击这个两个页面可以互相跳转

ts 复制代码
// src/main/ets/pages/Index.ets
@Entry
@Component
struct Index {
  // 创建导航路径栈实例,用于管理页面跳转历史
  pageStack: NavPathStack = new NavPathStack()

  build() {
    // 使用Navigation组件作为导航容器,传入pageStack管理路由
    Navigation(this.pageStack) {
      Column() {
      }
      .width('100%')
      .height('100%')
      .backgroundColor(Color.Blue)
      .onClick(() => {
        // 击时压入名为"MainPage"的新页面到路径栈
        this.pageStack.pushPathByName("MainPage", null);
      })
    }
  }
}
ts 复制代码
// src/main/ets/pages/MainPage.ets
// 跳转页面入口函数
@Builder
export function MainPageBuilder() {
  MainPage()
}

@Component
struct MainPage {
  pageStack: NavPathStack = new NavPathStack()

  build() {
    // 定义导航目标页面的容器
    NavDestination() {
    }
    .width('100%')
    .height('100%')
    .backgroundColor(Color.Brown)
    .title('MainPage')
    .onClick(() => {
      // 清空导航路径栈(用于返回首页)
      this.pageStack.clear()
    })
    // 页面就绪回调onReady
    .onReady((context: NavDestinationContext) => {
      // 从上下文中获取路径栈实例(需确保与父组件共享同一个实例)
      this.pageStack = context.pathStack
    })
  }
}

路由相关的配置

在跳转目标模块的配置文件 module.json5 添加路由表配置

ts 复制代码
// src/main/module.json5
  {
    "module" : {
      "routerMap": "$profile:route_map"
    }
  }

添加完路由配置文件地址后,需要在工程 resources/base/profile 中创建 route_map.json 文件

ts 复制代码
// src/main/resources/base/profile/router_map.json
{
  "routerMap": [
    {
      "name": "MainPage",
      "pageSourceFile": "src/main/ets/pages/MainPage.ets",
      "buildFunction": "MainPageBuilder",
      "data": {
        "description": "this is MainPage"
      }
    }
  ]
}
ts 复制代码
// src/main/resources/base/profile/main_pages.json
{
  "src": [
    "pages/Index"
  ]
}
相关推荐
Georgewu7 小时前
【HarmonyOS】元服务入门详解 (一)
harmonyos
coder_pig8 小时前
跟🤡杰哥一起学Flutter (三十五、玩转Flutter滑动机制📱)
android·flutter·harmonyos
睿麒12 小时前
鸿蒙app 开发中的Record<string,string>的用法和含义
华为·harmonyos
cainiao08060514 小时前
华为HarmonyOS 5.0深度解析:跨设备算力池技术白皮书(2025全场景智慧中枢)
华为·harmonyos
万少15 小时前
04-自然壁纸实战教程-搭建基本工程
前端·harmonyos·客户端
yrjw16 小时前
FileSaver是一个为HarmonyOS ArkTS应用设计的开源库,提供便捷的文件保存功能。主要特性包括:支持将图片保存至系统相册和应用沙盒存储,支持多种
harmonyos
xo1988201118 小时前
鸿蒙选择本地视频文件,并获取首帧预览图
华为·harmonyos
在人间耕耘19 小时前
HarmonyOS组件/模板集成创新活动-开发者工具箱
华为·harmonyos
二流小码农20 小时前
鸿蒙开发:一键更新,让应用无需提交应用市场即可下载安装
android·ios·harmonyos
xyccstudio20 小时前
鸿蒙选择本地视频文件,并获取首帧预览图
harmonyos