一、页面跳转
在一个应用包含一个UIAbility的场景下,可以通过新建多个页面来实现和丰富应用的内容。这会涉及到UIAbility内页面的新建以及UIAbility内页面的跳转和数据传递。
打开DevEco Studio,选择一个Empty Ability工程模板,创建一个工程,例如命名为MyApplication。一些目录的介绍:
1、在src/main/ets/entryability目录下,初始会生成一个UIAbility文件EntryAbility.ts。可以在EntryAbility.ts文件中根据业务需要实现UIAbility的生命周期回调内容。
2、在src/main/ets/pages目录下,会生成一个Index页面。这也是基于UIAbility实现的应用的入口页面。可以在Index页面中根据业务需要实现入口页面的功能。
3、在src/main/ets/pages目录下,右键New->Page,新建一个Second页面,用于实现页面间的跳转和数据传递。
实现步骤:
- 为了实现页面的跳转和数据传递,需要新建一个页面。在原有Index页面的基础上,新建一个页面,例如命名为Second.ets。
- 页面间的导航可以通过页面路由router模块来实现。页面路由模块根据页面url找到目标页面,从而实现跳转。通过页面路由模块,可以使用不同的url访问不同的页面,包括跳转到UIAbility内的指定页面、用UIAbility内的某个页面替换当前页面、返回上一页面或指定的页面等。
import router from '@ohos.router';
EntryAbility.ts文件内容不变
Index.ets第一个页面代码:
import router from '@ohos.router';
@Entry
@Component
struct Index {
@State message: string = 'Index Pages';
build() {
Row() {
Column() {
Text(this.message)
.fontSize(32)
.fontWeight(FontWeight.Bold)
Blank()
Button("Next")
.width('296vp')
.height('40vp')
.margin({ top: 20 })
.fontSize('16fp')
.onClick(() => {
router.pushUrl({
url: 'pages/Second',
params: {
name: "Index页面传来的数据",
}
}, router.RouterMode.Single)
})
}
.width('100%')
}
.height('100%')
}
}
Second.ets第二个页面代码:
import router from '@ohos.router';
@Entry
@Component
struct Second {
@State message: string = 'Second Pages';
@State name: string = (router.getParams() as Record<string, string>)['name'];
build() {
Row() {
Column() {
Text(this.message)
.fontSize(32)
.fontWeight(FontWeight.Bold)
Text(this.name)
.fontSize(20)
.fontWeight(FontWeight.Bold)
.opacity(0.6)
.fontColor(Color.Red)
Blank()
Button("Next")
.width('296vp')
.height('40vp')
.margin({ top: 20 })
.fontSize('16fp')
.onClick(() => {
router.replaceUrl({
url: 'pages/ThreePage',
params: {
name: "Second页面传来的数据",
}
}, router.RouterMode.Single)
})
Blank()
Button("Back")
.width('296vp')
.height('40vp')
.margin({ top: 20 })
.fontSize('16fp')
.onClick(() => {
router.back();
})
}
.width('100%')
}
.height('100%')
}
}
ThreePage.ets第三个页面代码:
import router from '@ohos.router';
@Entry
@Component
struct ThreePage {
@State message: string = 'Three Pages'
@State name: string = (router.getParams() as Record<string, string>)['name'];
build() {
Row() {
Column() {
Text(this.message)
.fontSize(32)
.fontWeight(FontWeight.Bold)
Text(this.name)
.fontSize(20)
.fontWeight(FontWeight.Bold)
.opacity(0.6)
.fontColor(Color.Red)
Blank()
Button("Back")
.width('296vp')
.height('40vp')
.margin({ top: 20 })
.fontSize('16fp')
.onClick(() => {
router.back();
})
}
.width('100%')
}
.height('100%')
}
}
注意:从中也可以看出,从第一个页面跳转到第二个页面使用的是router.pushUrl(...)方式跳转页面,而第二个页面跳转到第三个页面使用的是router.replaceUrl(...)方式。
方式一:API9及以上,router.pushUrl()方法新增了mode参数,可以将mode参数配置为router.RouterMode.Single单实例模式和router.RouterMode.Standard多实例模式。
说明:当页面栈的元素数量较大或者超过32时,可以通过调用router.clear()方法清除页面栈中的所有历史页面,仅保留当前页面作为栈顶页面。
router.pushUrl({
url: 'pages/Second',
params: {
name: 'Index页面传来的数据',
}
}, router.RouterMode.Single)
方式二:API9及以上,router.replaceUrl()方法新增了mode参数,可以将mode参数配置为router.RouterMode.Single单实例模式和router.RouterMode.Standard多实例模式。
router.replaceUrl({
url: 'pages/ThreePage',
params: {
name: 'Second页面传来的数据',
}
}, router.RouterMode.Single)
页面跳转的几种方式,根据需要选择一种方式跳转即可。
操作示意:
点击Index.ets页面“Next”按钮,会跳转到Second.ets页面。
在Second.ets页面点击“Next”按钮,会跳转到ThreePage.ets页面
在Second.ets页面点击“Back”按钮,会返回到Index.ets页面
在ThreePage.ets页面点击“Back”按钮,会返回到Index.ets页面
二、页面返回与参数接收
在Second页面中,可以通过调用router.back()方法实现返回到上一个页面,或者在调用router.back()方法时增加可选的options参数(增加url参数)返回到指定页面。
说明:调用router.back()返回的目标页面需要在页面栈中存在才能正常跳转。
例如调用router.pushUrl()方法跳转到Second页面,在Second页面可以通过调用router.back()方法返回到上一个页面。
例如调用router.clear()方法清空了页面栈中所有历史页面,仅保留当前页面,此时则无法通过调用router.back()方法返回到上一个页面。
返回上一个页面:
router.back();
返回到指定页面:
router.back({ url: 'pages/Index' });
已经实现了页面的跳转,接下来,在Second页面中如何进行自定义参数的接收呢?
通过调用router.getParams()方法获取Index页面传递过来的自定义参数。
import router from '@ohos.router';
@Entry
@Component
struct Second {
@State name: string = (router.getParams() as Record<string, string>)['name'];
// 页面刷新展示
...
}