IT评测·应用市场-qidao123.com技术社区

标题: 【HarmonyOS NEXT 】应用开发：ArkTS页面和自定义组件生命周期 [打印本页]

---

作者: 西河刘卡车医    时间: 2024-10-24 14:53
标题: 【HarmonyOS NEXT 】应用开发：ArkTS页面和自定义组件生命周期
SDK：5.0.0
DevEco Studio：5.0.3
Node.js：18.20.1
  一、基础概念

• 自定义组件：@Component装饰的UI单位。
  
• 页面：@Entry装饰的自定义组件为页面的入口组件，即页面的根节点，一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。
  
• 应用的UI页面可以由一个或者多个自定义组件组成。
  

二、生命周期示意图及介绍

1、页面生命周期（即被@Entry装饰的组件生命周期），生命周期接口：

• onPageShow：页面每次显示时触发一次，包括路由过程、应用进入前台等场景。
  
• onPageHide：页面每次隐藏时触发一次，包括路由过程、应用进入后台等场景。
  
• onBackPress：当用户点击返回按钮时触发。
  

2、组件生命周期（即一样平常用@Component装饰的自定义组件的生命周期），生命周期接口：

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

三、生命周期调用时机示例

1、干系代码

1. // Index.ets
2. import router from '@ohos.router';
4. /**
5. * 页面的根节点，一个页面仅有一个@Entry
6. * */
7. @Entry
8. @Component
9. struct MyComponent {
10.   @State showChild: boolean = true;
12.   // 组件生命周期、组件生命周期
13.   aboutToAppear() {
14.     console.info('MyComponent aboutToAppear');
15.   }
17.   // 组件生命周期、组件生命周期
18.   aboutToDisappear() {
19.     console.info('MyComponent aboutToDisappear');
20.   }
22.   // *** 只有被@Entry装饰的组件才可以调用页面的生命周期 *** START ***//
23.   // 页面每次显示时触发一次
24.   onPageShow() {
25.     console.info('Index onPageShow，页面每次显示时触发一次');
26.   }
27.   // 页面每次隐藏时触发一次
28.   onPageHide() {
29.     console.info('Index onPageHide，页面每次隐藏时触发一次');
30.   }
32.   // 当用户点击返回按钮时触发
33.   onBackPress() {
34.     console.info('Index onBackPress，当用户点击返回按钮时触发');
35.   }
36.   // *** 只有被@Entry装饰的组件才可以调用页面的生命周期 *** END ***//
38.   build() {
39.     Column() {
40.       // this.showChild为true，创建Child子组件，执行Child aboutToAppear
41.       if (this.showChild) {
42.         Child()
43.       }
44.       // this.showChild为false，删除Child子组件，执行Child aboutToDisappear
45.       Button('delete Child').onClick(() => {
46.         this.showChild = false;
47.       })
48.       // push到Page2页面，执行onPageHide
49.       Button('push to next page')
50.         .onClick(() => {
51.           router.pushUrl({ url: 'pages/Page2' });
52.         })
53.     }
55.   }
56. }
58. /**
59. * 自定义组件，不能增加@Entry修饰
60. * */
61. @Component
62. struct Child {
63.   @State title: string = 'Hello World';
65.   // 组件生命周期、组件即将出现时回调该接口
66.   aboutToAppear() {
67.     console.info('[lifeCycle] Child aboutToAppear，组件即将出现时回调该接口')
68.   }
69.   // 组件生命周期、在组件销毁之前执行
70.   aboutToDisappear() {
71.     console.info('[lifeCycle] Child aboutToDisappear，在组件销毁之前执行')
72.   }
74.   build() {
75.     Text(this.title).fontSize(50).onClick(() => {
76.       this.title = 'Hello ArkUI';
77.     })
78.   }
79. }

复制代码

2、实行结果

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企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 IT评测·应用市场-qidao123.com技术社区 (https://dis.qidao123.com/)

Powered by Discuz! X3.4