挂载卸载事件

挂载卸载事件指组件从组件树上挂载、卸载时触发的事件。

说明：

从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

onAttach12+

onAttach(callback: Callback<void>): T

组件挂载至组件树时触发此回调。

说明：

回调的调用时机一定在组件布局渲染之前。

不允许在回调中对组件树进行变更，例如启动动画，或是使用if-else变更组件树结构。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
T	返回当前组件。

onDetach12+

onDetach(callback: Callback<void>): T

组件从组件树卸载时触发此回调。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
T	返回当前组件。

onAppear

onAppear(event: () => void): T

组件挂载显示后触发此回调。

说明：

回调的调用时机有可能发生在组件布局渲染后。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
T	返回当前组件。

onDisAppear

onDisAppear(event: () => void): T

组件卸载消失时触发此回调。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

返回值：

类型	说明
T	返回当前组件。

示例

// xxx.ets
import promptAction from '@ohos.promptAction'

@Entry
@Component
struct AppearExample {
  @State isShow: boolean = true
  @State changeAppear: string = '点我卸载挂载组件'
  private myText: string = 'Text for onAppear'

  build() {
    Column() {
      Button(this.changeAppear)
        .onClick(() => {
          this.isShow = !this.isShow
        }).margin(15)
      if (this.isShow) {
        Text(this.myText).fontSize(26).fontWeight(FontWeight.Bold)
          .onAttach(() => {
            promptAction.showToast({
              message: 'The text is shown',
              duration: 2000,
              bottom: 500
            })
          })
          .onDetach(() => {
            promptAction.showToast({
              message: 'The text is hidden',
              duration: 2000,
              bottom: 500
            })
          })
      }
    }.padding(30).width('100%')
  }
}
ts