鸿蒙5.0开发进阶：ArkTS组件-设置事件回调

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

设置事件回调

说明

本模块首批接口从API version 12开始支持，后续版本的新增接口，采用上角标单独标记接口的起始版本。

UICommonEvent

用于设置基础事件回调。方法入参为undefined的时候，重置对应的事件回调。

setOnClick

setOnClick(callback: Callback<ClickEvent> | undefined): void

设置点击事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<ClickEvent> | undefined	是	点击事件的回调函数。

setOnTouch

setOnTouch(callback: Callback<TouchEvent> | undefined): void

设置触摸事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<TouchEvent> | undefined	是	触摸事件的回调函数。

setOnAppear

setOnAppear(callback: Callback<void> | undefined): void

设置onAppear事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<void> | undefined	是	onAppear事件的回调函数。

setOnDisappear

setOnDisappear(callback: Callback<void> | undefined): void

设置onDisappear事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<void> | undefined	是	onDisappear事件的回调。

setOnKeyEvent

setOnKeyEvent(callback: Callback<KeyEvent> | undefined): void

设置按键事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<KeyEvent> | undefined	是	按键事件的回调函数。

setOnFocus

setOnFocus(callback: Callback<void> | undefined): void

设置onFocus事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<void> | undefined	是	onFocus事件的回调。

setOnBlur

setOnBlur(callback: Callback<void> | undefined): void

设置onBlur事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<void> | undefined	是	onBlur事件的回调。

setOnHover

setOnHover(callback: HoverCallback | undefined): void

设置onHover事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	HoverCallback | undefined	是	onHover事件的回调函数。

setOnMouse

setOnMouse(callback: Callback<MouseEvent> | undefined): void

设置onMouse事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	Callback<MouseEvent> | undefined	是	onMouse事件的回调函数。

setOnSizeChange

setOnSizeChange(callback: SizeChangeCallback | undefined): void

设置onSizeChange事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
callback	SizeChangeCallback | undefined	是	onSizeChange事件的回调函数。

setOnVisibleAreaApproximateChange

setOnVisibleAreaApproximateChange(options: VisibleAreaEventOptions, event: VisibleAreaChangeCallback | undefined): void

设置限制回调间隔的onVisibleAreaChange事件的回调。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

参数：

参数名	类型	必填	说明
options	VisibleAreaEventOptions	是	可见区域变化相关的参数。
event	VisibleAreaChangeCallback | undefined	是	onVisibleAreaChange事件的回调函数。当组件可见面积与自身面积的比值接近options中设置的阈值时触发该回调。

说明

非实时回调，实际回调与预期间隔可能存在差别。

两次可见区域回调的时间间隔不小于预期更新间隔。当开发者设置的预期间隔过小时，由系统负载决定实际回调间隔时间。

当前接口的可见区域回调阈值默认包含0。例如，开发者设置回调阈值为[0.5]，实际生效的阈值为[0.0, 0.5]。