页面路由指在应用程序中实现不同页面之间的跳转和数据传递。HarmonyOS提供了Router模块，通过不同的url地址，可以方便地进行页面路由，轻松地访问不同的页面。

页面跳转

页面跳转是开发过程中的一个重要组成部分。在使用应用程序时，通常需要在不同的页面之间跳转，有时还需要将数据从一个页面传递到另一个页面。

两种跳转模式

Router模块提供了两种跳转模式，分别是router.pushUrl()和router.replaceUrl()。这两种模式决定了目标页是否会替换当前页。

router.pushUrl()：目标页不会替换当前页，而是压入页面栈。这样可以保留当前页的状态，并且可以通过返回键或者调用router.back()方法返回到当前页。
router.replaceUrl()：目标页会替换当前页，并销毁当前页。这样可以释放当前页的资源，并且无法返回到当前页。

两种实例模式

同时，Router模块提供了两种实例模式，分别是Standard和Single。这两种模式决定了目标url是否会对应多个实例。

Standard：标准实例模式，也是默认情况下的实例模式。每次调用该方法都会新建一个目标页，并压入栈顶。
Single：单实例模式。即如果目标页的url在页面栈中已经存在同url页面，则离栈顶最近的同url页面会被移动到栈顶，并重新加载；如果目标页的url在页面栈中不存在同url页面，则按照标准模式跳转。

带参传递

如果需要在跳转时传递一些数据给目标页，则可以在调用Router模块的方法时，添加一个params属性，并指定一个对象作为参数。在目标页中，可以通过调用Router模块的getParams()方法来获取传递过来的参数。

前期准备

在使用页面路由Router相关功能之前，需要在代码中先导入Router模块。

import router from '@ohos.router';

页面返回

当用户在一个页面完成操作后，通常需要返回到上一个页面或者指定页面，这就需要用到页面返回功能。在返回的过程中，可能需要将数据传递给目标页，这就需要用到数据传递功能。

返回到上一个页面

router.back();

返回到指定页面

router.back({

url: 'pages/Home'

});

这种方式可以返回到指定页面，需要指定目标页的路径。目标页必须存在于页面栈中才能够返回。

返回到指定页面，并传递自定义参数信息

router.back({

url: 'pages/Home',

params: {

info: '来自Home页'

}

});

这种方式不仅可以返回到指定页面，还可以在返回的同时传递自定义参数信息。这些参数信息可以在目标页中通过调用router.getParams()方法进行获取和解析。

在目标页中，在需要获取参数的位置调用router.getParams()方法即可，例如在onPageShow()生命周期回调中：

onPageShow() {

const params = router.getParams(); // 获取传递过来的参数对象

const info = params['info']; // 获取info属性的值

}

示例

import router from '@ohos.router';

import { DataModel } from '../model/DataModelInfo'

let paramsInfo: DataModel = {

id: 123,

info: {

index: 'Index页面'

}

};

@Entry

@Component

struct Index {

@State message: string = 'Hello World'

build() {

Row() {

Column() {

Button("跳转到IndexTestA界面").onClick(_ => {

router.pushUrl({

url: 'pages/IndexTestA' // 目标url

}, router.RouterMode.Standard, (err) => {

if (err) {

console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`);

return;

}

console.info('Invoke pushUrl succeeded.');

});

}).margin({ bottom: 10 })

Button("跳转到IndexTestA界面并传递数据").onClick(_ => {

router.pushUrl({

url: 'pages/IndexTestA', // 目标url

params: paramsInfo

}, router.RouterMode.Standard, (err) => {

if (err) {

console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`);

return;

}

console.info('Invoke pushUrl succeeded.');

});

}).margin({ bottom: 10 })

Button("跳转到IndexTestA并替换当前界面").onClick(_ => {

router.replaceUrl({

url: 'pages/IndexTestA' // 目标url

}, router.RouterMode.Standard, (err) => {

if (err) {

console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`);

return;

}

console.info('Invoke pushUrl succeeded.');

});

}).margin({ bottom: 10 })

Button("跳转到IndexTestB界面").onClick(_ => {

router.pushUrl({

url: 'pages/IndexTestB' // 目标url

}, router.RouterMode.Standard, (err) => {

if (err) {

console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`);

return;

}

console.info('Invoke pushUrl succeeded.');

});

}).margin({ bottom: 10 })

Button("跳转到IndexTestB并替换当前界面").onClick(_ => {

router.replaceUrl({

url: 'pages/IndexTestB' // 目标url

}, router.RouterMode.Standard, (err) => {

if (err) {

console.error(`Invoke pushUrl failed, code is ${err.code}, message is ${err.message}`);

return;

}

console.info('Invoke pushUrl succeeded.');

});

})

}

.width('100%')

}

.height('100%')

}

import router from '@ohos.router';

@Entry

@Component

struct IndexTestA {

@State message: string = 'Hello World'

@State sourceData: string = ''

build() {

Row() {

Column() {

if (this.sourceData != '') {

Text(`来自${this.sourceData}的数据`)

}

Text("IndexTestA").fontSize(20).margin({ bottom: 10 })

Button("返回按钮").onClick(_ => {

router.back()

}).margin({ bottom: 10 })

Button("跳转到Index").onClick(_ => {

router.pushUrl({ url: 'pages/Index' })

}).margin({ bottom: 10 })

Button("Single方式跳转到Index").onClick(_ => {

router.pushUrl({ url: 'pages/Index' }, router.RouterMode.Single)

}).margin({ bottom: 10 })

}.padding(20)

.width('100%')

}

.height('100%')

}

onPageShow() {

const params = router.getParams(); // 获取传递过来的参数对象

if (params==null) {

return

}

if (params['info']!=null) {

console.log('info',"params"+params['id'])

console.log('info',"params['info'].index"+params['info'].index)

this.sourceData = params['info'].index; // 获取info属性的值

}

import router from '@ohos.router';

import { DataModel } from '../model/DataModelInfo'

let paramsInfo: DataModel = {

id: 123,

info: {

index: 'IndexTestB页面'

}

};

@Entry

@Component

struct IndexTestB {

@State message: string = 'Hello World'

build() {

Row() {

Column() {

Text("IndexTestB").fontSize(20).margin({ bottom: 10 })

Button("返回按钮").onClick(_ => {

router.back()

}).margin({ bottom: 10 })

Button("返回到指定IndexTestA按钮").onClick(_ => {

router.back({ url: 'pages/IndexTestA' })

}).margin({ bottom: 10 })

Button("返回到指定IndexTestA并携带参数").onClick(_ => {

router.back({ url: 'pages/IndexTestA', params: paramsInfo });

}).margin({ bottom: 10 })

Button("跳转到Index").onClick(_ => {

router.pushUrl({ url: 'pages/Index' })

}).margin({ bottom: 10 })

Button("Single方式跳转到Index").onClick(_ => {

router.pushUrl({ url: 'pages/Index' }, router.RouterMode.Single)

}).margin({ bottom: 10 })

}.padding(20)

.width('100%')

}

.height('100%')

}

如上是三个界面，然后是三个界面之间的跳转返回，如下是跳转的演示：

20230504-114319

20230504-114152

005 页面路由

页面跳转

两种跳转模式

两种实例模式

带参传递

前期准备

页面返回

返回到上一个页面

返回到指定页面

返回到指定页面，并传递自定义参数信息

示例

猜你喜欢