鸿蒙NEXT开发【焦点事件】ArkTS组件

焦点事件指页面焦点在可获焦组件间移动时触发的事件，组件可使用焦点事件来处理相关逻辑。

说明

• 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 目前仅支持通过外接键盘的tab键、方向键触发。不支持嵌套滚动组件场景按键走焦。
• 存在默认交互逻辑的组件例如[Button]、[TextInput]等，默认即为可获焦，[Text]、[Image]等组件默认状态为不可获焦，不可获焦状态下，无法触发焦点事件，需要设置focusable属性为true才可触发。

onFocus

onFocus(event: () => void)

当前组件获取焦点时触发的回调。

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

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

onBlur

onBlur(event:() => void)

当前组件失去焦点时触发的回调。

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

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

示例

// xxx.ets
@Entry
@Component
struct FocusEventExample {
  @State oneButtonColor: string