# 挂载卸载事件
挂载卸载事件指组件从组件树上挂载、卸载时触发的事件。
> **说明：**
>
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## onAttach12+
onAttach(callback: Callback\): T
组件挂载至组件树时触发此回调。
> **说明：**
>
> 回调的调用时机一定在组件布局渲染之前。
>
> 不允许在回调中对组件树进行变更，例如启动动画，或是使用if-else变更组件树结构。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
**系统能力：** SystemCapability.ArkUI.ArkUI.Full
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| T | 返回当前组件。 |
## onDetach12+
onDetach(callback: Callback\): T
组件从组件树卸载时触发此回调。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。
**系统能力：** 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 | 返回当前组件。 |
## 示例
该示例通过按钮控制组件的卸载和挂载，触发onAttach和onDetach事件。
```ts
// xxx.ets
import { promptAction } from '@kit.ArkUI'
@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%')
}
}
```
