Ability内页面间的跳转（ArkTS）

介绍

本篇Codelab基于Stage模型下的Ability开发，实现Ability内页面间的跳转和数据传递。

最终效果图如下：

相关概念

• 页面路由：提供通过不同的url访问不同的页面，包括跳转到应用内的指定页面、用应用内的某个页面替换当前页面、返回上一页面或指定的页面等。

环境搭建

软件要求

• DevEco Studio版本：DevEco Studio 3.1 Release。
• OpenHarmony SDK版本：API version 9。

硬件要求

• 开发板类型：润和RK3568开发板。
• OpenHarmony系统：3.2 Release。

环境搭建

完成本篇Codelab我们首先要完成开发环境的搭建，本示例以RK3568开发板为例，参照以下步骤进行：

1. 获取OpenHarmony系统版本：标准系统解决方案（二进制）。以3.2 Release版本为例：

   

2. 搭建烧录环境。

   1. 完成DevEco Device Tool的安装
   2. 完成RK3568开发板的烧录

3. 搭建开发环境。

   1. 开始前请参考工具准备，完成DevEco Studio的安装和开发环境配置。
   2. 开发环境配置完成后，请参考使用工程向导创建工程（模板选择“Empty Ability”）。
   3. 工程创建完成后，选择使用真机进行调测。

代码结构解读

本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。

├──entry/src/main/ets                // 代码区
│  ├──common
│  │  ├──constants
│  │  │  └──CommonConstants.ets      // 公共常量类
│  │  └──utils
│  │    └──Logger.ets                // 日志类
│  ├──entryability
│  │  └──EntryAbility.ets            // 程序入口类
│  └──pages
│     ├──IndexPage.ets               // 入口页面
│     └──SecondPage.ets              // 跳转页
└──entry/src/main/resources          // 资源文件目录

页面跳转

1. 在工程pages目录中，选中Index.ets，点击鼠标右键 > Refactor > Rename，改名为IndexPage.ets。改名后，修改工程entryability目录下EntryAbility.ets文件中windowStage.loadContent方法第一个参数为pages/IndexPage。

   // EntryAbility.ets
   onWindowStageCreate(windowStage: Window.WindowStage): void {
     ...
     windowStage.loadContent('pages/IndexPage', (err, data) => {
       ...
     });
   }
   

2. 在工程pages目录中，点击鼠标右键 > New > Page，新建命名为SecondPage的page页。

3. 从IndexPage页面跳转到SecondPage页面，并进行数据传递，需要如下几个步骤：

   • 给两个页面导入router路由模块。
   • 在IndexPage页面中给Button组件添加点击事件，使用router.pushUrl()方法将SecondPage页面路径添加到url中，params为自定义参数。
   • SecondPage页面通过router.getParams()方法获取IndexPage页面传递过来的自定义参数。

   IndexPage页面有一个Text文本和Button按钮，点击按钮跳转到下一个页面，并传递数据。IndexPage.ets代码如下：

   // IndexPage.ets
   import router from '@ohos.router';
   import CommonConstants from '../common/constants/CommonConstants';
   
   @Entry
   @Component
   struct IndexPage {
     @State message: string = CommonConstants.INDEX_MESSAGE;
   
     build() {
       Row() {
         Column() {
           Text(this.message)
             ...
           Blank()
           Button($r('app.string.next'))
             ...
             .onClick(() => {
               router.pushUrl({
                 url: CommonConstants.SECOND_URL,
                 params: {
                   src: CommonConstants.SECOND_SRC_MSG
                 }
              }).catch((error: Error) => {
                Logger.info(TAG, 'IndexPage push error' + JSON.stringify(error));
              });
           })
         }
         ...
       }
       ...
     }
   }
   

   SecondPage页面有两个Text文本，其中一个文本展示从IndexPage页面传递过来的数据。SecondPage.ets代码如下：

   // SecondPage.ets
   import router from '@ohos.router';
   import CommonConstants from '../common/constants/CommonConstants';
   
   @Entry
   @Component
   struct Second {
     @State message: string = CommonConstants.SECOND_MESSAGE;
     @State src: string = (router.getParams() as Record<string, string>)[CommonConstants.SECOND_SRC_PARAM];
   
     build() {
       Row() {
         Column() {
           Text(this.message)
             ...
           Text(this.src)
             ...
         }
         ...
       }
       ...
     }
   }
   

页面返回

在SecondPage页面中，Button按钮添加onClick()事件。调用router.back()方法，实现返回上一页面的功能。

// SecondPage.ets
Button($r('app.string.back'))
  ...
  .onClick(() => {
    router.back();
  })

总结

您已经完成了本次Codelab的学习，并了解到以下知识点：

1. 使用页面路由实现应用内页面跳转。