目录

物理键盘输入异常分析

问题现象

应用在不同设备上使用时,部分依赖物理键盘的交互方式会出现输入异常,具体表现为物理键盘无法正常输入内容,导致用户无法通过键盘进行交互操作,影响用户体验和应用功能的正常运行。

场景一:组件未获取焦点,导致物理键盘输入响应异常。

场景二:按键事件数据流中事件分发不正确(如快捷键冲突、对应消费组件不正确等),导致物理键盘输入异常。

场景三:Web组件获焦后,键盘事件无法冒泡到父ArkUI组件。

背景知识

定位过程

分析结论

场景一:

由于组件未获取焦点,导致物理键盘输入响应异常。

场景二:

由于按键事件数据流中事件分发不正确,如快捷键冲突、对应消费组件不正确等,导致物理键盘输入异常。

场景三:

Web组件获焦后消费了键盘事件,事件不会冒泡回传给ArkUI父组件,导致父组件无法响应键盘事件。

修改建议

场景一:

使用defaultFocus和requestFocus等方式,确保输入框组件在物理键盘输入时获得焦点,详情请参考支持焦点处理。

场景二:

onKeyEvent、onKeyPreIme和onKeyEventDispatch的区别仅在于触发的时机,当绑定方法的组件处于获焦状态下,外设键盘的按键事件会触发上述方法,回调参数为KeyEvent。相关示例可以参考onKeyEvent & onKeyPreIme。

onKeyEvent事件默认是冒泡的(stopPropagation方法可阻止冒泡,参考示例)。

每个按键都有两次回调,分别对应KeyType.Down和KeyType.Up,表示按键被按下、然后抬起。

场景三:

在父组件上使用onKeyEventDispatch拦截键盘事件。onKeyEventDispatch在按键事件分发到获焦组件之前触发,可在父组件层面优先拦截并处理事件,无需依赖事件冒泡机制。