目录

自定义组件生命周期

自定义组件生命周期,即用@Component或@ComponentV2装饰的自定义组件的生命周期,提供以下生命周期接口:

页面生命周期及其相关内容参考页面路由。

自定义组件生命周期流程如下图所示。

根据上面的流程图,接下来从自定义组件的初始创建、重新渲染和删除来详细说明。

自定义组件的创建和渲染流程

  1. 自定义组件的创建:自定义组件的实例由ArkUI框架创建。

  2. 初始化自定义组件的成员变量:通过本地默认值或者构造方法传递参数来初始化自定义组件的成员变量,初始化顺序为成员变量的定义顺序。

  3. 如果开发者定义了aboutToAppear,则执行build函数之前执行该方法。

  4. 在首次渲染的时候,执行build函数渲染系统组件,如果子组件为自定义组件,则创建自定义组件的实例。在首次渲染的过程中,框架会记录状态变量和组件的映射关系,当状态变量改变时,驱动其相关的组件刷新。

  5. 如果开发者定义了onDidBuild,则执行build函数之后执行该方法。

自定义组件重新渲染

当触发事件(比如点击)改变状态变量时,或者LocalStorage / AppStorage中的属性更改,并导致绑定的状态变量更改其值时:

  1. 框架观察到变化,启动重新渲染。

  2. 根据框架记录的状态变量和组件的映射关系,仅刷新发生变化的状态变量所关联的组件,实现最小化更新。

自定义组件的删除

例如if组件的分支改变或ForEach循环渲染中数组的个数改变,组件将被移除:

  1. 在删除组件之前,将调用其aboutToDisappear生命周期函数,标记着该节点将要被销毁。ArkUI的节点删除机制是:后端节点直接从组件树上摘下,后端节点被销毁,对前端节点解引用,前端节点已经没有引用时,将被Ark虚拟机垃圾回收。

  2. 自定义组件和它的变量将被删除,如果组件有同步的变量(如@Link、@Prop、@StorageLink),将从状态数据源上取消注册。

不建议在生命周期aboutToDisappear中使用async await。如果在此生命周期中使用异步操作(如 Promise 或回调方法),自定义组件将被保留在Promise的闭包中,直到回调方法执行完毕,这会阻止自定义组件的垃圾回收。

自定义组件嵌套使用与示例

通过以下示例,来详细说明自定义组件在嵌套使用时,自定义组件生命周期的调用时序:

import { hilog } from '@kit.PerformanceAnalysisKit';

@Entry
@Component
struct Parent {
  @State showChild: boolean = true;
  @State btnColor: string = '#FF007DFF';

  // Parent即将出现时,回调该方法
  aboutToAppear() {
    hilog.info(0x0000, 'testTag', 'Parent aboutToAppear');
  }

  // Parent首次渲染触发的build函数执行完成之后,回调该方法
  onDidBuild() {
    hilog.info(0x0000, 'testTag', 'Parent onDidBuild');
  }

  // Parent销毁之前,回调该方法
  aboutToDisappear() {
    hilog.info(0x0000, 'testTag', 'Parent aboutToDisappear');
  }

  build() {
    Column() {
      // this.showChild为true,创建Child子组件,执行Child aboutToAppear和Child onDidBuild。
      if (this.showChild) {
        Child()
      }
      Button(this.showChild ? 'delete Child' : 'add Child')
        .width(300)
        .margin(20)
        .backgroundColor(this.btnColor)
        .onClick(() => {
          // 更改this.showChild为false,删除Child子组件,执行Child aboutToDisappear。
          // 更改this.showChild为true,添加Child子组件,执行Child aboutToAppear和Child onDidBuild。
          this.showChild = !this.showChild;
        })
    }
    .width('100%')
  }
}

@Component
struct Child {
  @State title: string = 'Hello World';

  // Child销毁之前,回调该方法
  aboutToDisappear() {
    hilog.info(0x0000, 'testTag', 'Child aboutToDisappear');
  }

  // Child首次渲染触发的build函数执行完成之后,回调该方法
  onDidBuild() {
    hilog.info(0x0000, 'testTag', 'Child onDidBuild');
  }

  // Child即将出现时,回调该方法
  aboutToAppear() {
    hilog.info(0x0000, 'testTag', 'Child aboutToAppear');
  }

  build() {
    Text(this.title)
      .fontSize(50)
      .margin(20)
      .onClick(() => {
        this.title = 'Hello ArkUI';
      })
  }
}

以上示例中,Index页面包含两个自定义组件,一个是Parent,一个是Child,Parent及其子组件Child分别声明了各自的自定义组件生命周期函数(aboutToAppear / onDidBuild / aboutToDisappear)。

Parent aboutToAppear
Parent onDidBuild
Child aboutToAppear
Child onDidBuild
Parent aboutToDisappear
Child aboutToDisappear
Parent aboutToAppear
Parent onDidBuild
Child aboutToAppear
Child onDidBuild

当showChild为默认值true时,该示例的生命周期流程图如下所示: