diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md index 28bcf4cae9827e31896105d0656f18a11e027504..90483a3056c5d0e61cce3b79bb3e130fc699c615 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md @@ -1,6 +1,6 @@ # 按键事件 -按键事件指组件与键盘、遥控器等按键设备交互时触发的事件,适用于所有可交互组件(默认可获焦),例如Button。对于Text,Image等不可获焦组件,可以设置focusable属性为true后使用按键事件。 +按键事件指组件与键盘、遥控器等按键设备交互时触发的事件,适用于所有可获焦组件,例如Button。对于Text,Image等默认不可获焦的组件,可以设置focusable属性为true后使用按键事件。 > **说明:** > @@ -12,7 +12,7 @@ | 名称 | 支持冒泡 | 功能描述 | | ---------------------------------------- | ---- | ---------------------------------------- | -| onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后,按键动作触发该方法调用,event参数见[KeyEvent](#keyevent对象说明)介绍。 | +| onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后,按键动作触发该回调,event返回值见[KeyEvent](#keyevent对象说明)介绍。 | ## KeyEvent对象说明 @@ -24,7 +24,7 @@ | keyText | string | 按键的键值。 | | keySource | [KeySource](ts-appendix-enums.md#keysource) | 触发当前按键的输入设备类型。 | | deviceId | number | 触发当前按键的输入设备ID。 | -| metaKey | number | 按键发生时元键的状态,1表示按压态,0表示未按压态。 | +| metaKey | number | 按键发生时元键(即Windows键盘的WIN键、Mac键盘的Command键)的状态,1表示按压态,0表示未按压态。 | | timestamp | number | 按键发生时的时间戳。 | | stopPropagation | () => void | 阻塞事件冒泡传递。 | @@ -36,20 +36,20 @@ @Entry @Component struct KeyEventExample { - @State text: string = '' - @State eventType: string = '' + @State text: string = ''; + @State eventType: string = ''; build() { Column() { - Button('KeyEvent').backgroundColor(0x2788D9) + Button('KeyEvent') .onKeyEvent((event: KeyEvent) => { if (event.type === KeyType.Down) { - this.eventType = 'Down' + this.eventType = 'Down'; } if (event.type === KeyType.Up) { - this.eventType = 'Up' + this.eventType = 'Up'; } - console.info(this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText) + this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText; }) Text(this.text).padding(15) }.height(300).width('100%').padding(35)