西河刘卡车医 发表于 2024-10-24 14:53:54

【HarmonyOS NEXT 】应用开发:ArkTS页面和自定义组件生命周期

SDK:5.0.0
DevEco Studio:5.0.3
Node.js:18.20.1
一、基础概念



[*]自定义组件:@Component装饰的UI单位。
[*]页面:@Entry装饰的自定义组件为页面的入口组件,即页面的根节点,一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。
[*]应用的UI页面可以由一个或者多个自定义组件组成。
二、生命周期示意图及介绍

https://i-blog.csdnimg.cn/direct/3c8fc79052ea4940be584c2cb07a82c6.png
1、页面生命周期(即被@Entry装饰的组件生命周期),生命周期接口:


[*]onPageShow:页面每次显示时触发一次,包括路由过程、应用进入前台等场景。
[*]onPageHide:页面每次隐藏时触发一次,包括路由过程、应用进入后台等场景。
[*]onBackPress:当用户点击返回按钮时触发。
2、组件生命周期(即一样平常用@Component装饰的自定义组件的生命周期),生命周期接口:


[*]aboutToAppear:组件即将出现时回调该接口,详细时机为在创建自定义组件的新实例后,在实行其build()函数之前实行。
[*]aboutToDisappear:在自定义组件析构销毁之前实行。不答应在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用步调行为不稳定。
三、生命周期调用时机示例

1、干系代码
// Index.ets
import router from '@ohos.router';

/**
* 页面的根节点,一个页面仅有一个@Entry
* */
@Entry
@Component
struct MyComponent {
@State showChild: boolean = true;

// 组件生命周期、组件生命周期
aboutToAppear() {
    console.info('MyComponent aboutToAppear');
}

// 组件生命周期、组件生命周期
aboutToDisappear() {
    console.info('MyComponent aboutToDisappear');
}

// *** 只有被@Entry装饰的组件才可以调用页面的生命周期 *** START ***//
// 页面每次显示时触发一次
onPageShow() {
    console.info('Index onPageShow,页面每次显示时触发一次');
}
// 页面每次隐藏时触发一次
onPageHide() {
    console.info('Index onPageHide,页面每次隐藏时触发一次');
}

// 当用户点击返回按钮时触发
onBackPress() {
    console.info('Index onBackPress,当用户点击返回按钮时触发');
}
// *** 只有被@Entry装饰的组件才可以调用页面的生命周期 *** END ***//

build() {
    Column() {
      // this.showChild为true,创建Child子组件,执行Child aboutToAppear
      if (this.showChild) {
      Child()
      }
      // this.showChild为false,删除Child子组件,执行Child aboutToDisappear
      Button('delete Child').onClick(() => {
      this.showChild = false;
      })
      // push到Page2页面,执行onPageHide
      Button('push to next page')
      .onClick(() => {
          router.pushUrl({ url: 'pages/Page2' });
      })
    }

}
}

/**
* 自定义组件,不能增加@Entry修饰
* */
@Component
struct Child {
@State title: string = 'Hello World';

// 组件生命周期、组件即将出现时回调该接口
aboutToAppear() {
    console.info(' Child aboutToAppear,组件即将出现时回调该接口')
}
// 组件生命周期、在组件销毁之前执行
aboutToDisappear() {
    console.info(' Child aboutToDisappear,在组件销毁之前执行')
}

build() {
    Text(this.title).fontSize(50).onClick(() => {
      this.title = 'Hello ArkUI';
    })
}
} 2、实行结果
https://i-blog.csdnimg.cn/direct/ade5d84a22fd46f6beec917b5699f8f4.png
3、代码实行过程详解
该页面包含两个自定义组件,一个是被@Entry装饰的MyComponent,也是页面的入口组件,即页面的根节点;一个是Child,是MyComponent的子组件。只有@Entry装饰的节点才可以使页面级别的生命周期方法生效,以是MyComponent中声明确当前Index页面的页面生命周期函数。MyComponent和其子组件Child也同时也声明确组件的生命周期函数。


[*]应用冷启动的初始化流程为:MyComponent aboutToAppear --> MyComponent build --> Child aboutToAppear --> Child build --> Child build实行完毕 --> MyComponent build实行完毕 --> Index onPageShow。
[*]点击“delete Child”,if绑定的this.showChild变成false,删除Child组件,会实行Child aboutToDisappear方法。
[*]点击“push to next page”,调用router.pushUrl接口,跳转到别的一个页面,当前Index页面隐藏,实行页面生命周期Index onPageHide。此处调用的是router.pushUrl接口,Index页面被隐藏,并没有销毁,以是只调用onPageHide。跳转到新页面后,实行初始化新页面的生命周期的流程。
[*]如果调用的是router.replaceUrl,则当前Index页面被销毁,实行的生命周期流程将变为:Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。上文已经提到,组件的销毁是从组件树上直接摘下子树,以是先调用父组件的aboutToDisappear,再调用子组件的aboutToDisappear,然后实行初始化新页面的生命周期流程。
[*]点击返回按钮,触发页面生命周期Index onBackPress,且触发返回一个页面后会导致当前Index页面被销毁。
[*]最小化应用或者应用进入后台,触发Index onPageHide。当前Index页面没有被销毁,以是并不会实行组件的aboutToDisappear。应用回到前台,实行Index onPageShow。
[*]退出应用,实行Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 【HarmonyOS NEXT 】应用开发:ArkTS页面和自定义组件生命周期