【HarmonyOS】HarmonyOS NEXT学习日记:七、页面与组件的生命周期
页面和组件
- 组件:用@Component装饰的代码称为自定义组件
- 页面:@Entry装饰的组件即页面的根节点
组件生命周期
aboutToAppear:在创建自定义组件的新实例后,在执行其build()函数之前执行。允许在aboutToAppear函数中改变状态变量,更改将在后续执行build()函数中生效。
aboutToDisappear:在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用程序行为不稳定。
页面生命周期
onPageShow:页面每次显示时触发一次,包括路由过程、应用进入前台等场景,仅@Entry装饰的自定义组件生效。
onPageHide:页面每次隐藏时触发一次,包括路由过程、应用进入后台等场景,仅@Entry装饰的自定义组件生效。
onBackPress:当用户点击返回按钮时触发,仅@Entry装饰的自定义组件生效。返回true表示页面自己处理返回逻辑,不进行页面路由;返回false表示使用默认的路由返回逻辑,不设置返回值按照false处理。
代码示例
// Index.ets
import text from '@ohos.graphics.text'
import { router } from '@kit.ArkUI';
// 导入业务错误处理模块
import { BusinessError } from '@kit.BasicServicesKit';
@Builder function TextItem(text: string){Text(text).fontSize(18).fontColor(Color.Red).backgroundColor('#ccc').lineHeight(30).width('100%').textAlign(TextAlign.Center).onClick(()=>{router.pushUrl({ url: 'pages/Second' }).then(() => { // 调用 router 模块的 pushUrl 方法跳转到第二页console.info('Succeeded in jumping to the second page.') // 在控制台输出跳转成功的日志信息}).catch((err: BusinessError) => { // 捕捉跳转过程中的错误console.error(`Failed to jump to the second page. Code is ${err.code}, message is ${err.message}`) // 在控制台输出跳转失败的错误信息,包括错误代码和错误信息})})
}
@Entry
@Component
struct Index {@State text: string = '111'@State showChildren: boolean = false;onPageShow() {this.text = 'onPageShow';console.info('IndexComponent onPageShow');}onPageHide() {this.text = 'onPageHide';console.info('IndexComponent onPageHide');}aboutToAppear(){this.text = '222'console.info('IndexComponent aboutToAppear');}aboutToDisappear(){console.info('IndexComponent aboutToDisappear');}build() {Column(){TextItem(this.text)if(this.showChildren){Child()}Button('修改children可见').onClick(()=>{this.showChildren = !this.showChildren})}}
}
@Component
struct Child {@State title: string = 'Children';aboutToDisappear() {console.info('Child aboutToDisappear')}aboutToAppear() {console.info('Child aboutToAppear')}build() {Text(this.title).fontSize(50).onClick(() => {this.title = 'Children Changed';})}
}
页面初始化结束后
可以看到的是,我们定义text变量时赋值的‘111’在aboutToAppear中已经被修改为‘222’了,最终渲染出来的就是‘222’;
从日志中我们可以观察到,aboutToDisappear的执行时机在onPageShow之前。
然后我们点击跳转一下页面(离开页面)
日志如下
组件并未被销毁,所以没有进入aboutToDisappear,但是因为离开了页面,所以进入了onPageHide。
当我们再次返回index页面(进入页面)
将会再次触发onPageShow,每一次页面显示时都会触发。
那么当我们点击按钮呢?(创建组件)
chidren子组件被渲染了出来,也出发了子组件的aboutToAppear。
再次点击按钮(销毁组件)
将会触发子组件的销毁进入aboutToDisappear,同时页面上的子组件也消失不见。
总结
页面显示|
ActivityA:onPageShow |
---|
------ 组件生命周期 ------ |
|组件将要出现|
CustomComponent:aboutToAppear |
---|
|组件的渲染和交互|用户按下返回按钮|
ActivityA:onBackPress |
---|
|组件将要消失|
CustomComponent:aboutToDisappear |
---|
|页面隐藏|
ActivityA:onPageHide |
---|