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 c395fff5bf5063607a475181f74d380729a951c0..cdcabb4b2d4b75a11d0c284074475e447be47ece 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,5 +1,7 @@ # 按键事件 +按键事件指组件与键盘、遥控器等按键设备交互时触发的事件。 + > **说明:** > 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。 @@ -13,21 +15,21 @@ | 名称 | 支持冒泡 | 功能描述 | | ---------------------------------------- | ---- | ---------------------------------------- | -| onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 按键动作触发该方法调用,event参数见[KeyEvent](#keyevent对象说明)介绍。 | +| onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后,按键动作触发该方法调用,event参数见[KeyEvent](#keyevent对象说明)介绍。 | ## KeyEvent对象说明 - 属性 - | 属性名称 | 类型 | 描述 | - | --------- | --------------------------- | -------------------------- | - | type | [KeyType](#keytype枚举说明) | 按键的类型。 | - | keyCode | number | 按键的键码。 | - | keyText | string | 按键的键值。 | - | keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。 | - | deviceId | number | 触发当前按键的输入设备ID。 | - | metaKey | number | 按键发生时元键的状态,1表示按压态,0表示未按压态。 | - | timestamp | number | 按键发生时的时间戳。 | + | 属性名称 | 类型 | 描述 | + | ------------------------------------- | --------------------------- | -------------------------- | + | type | [KeyType](#keytype枚举说明) | 按键的类型。 | + | [keyCode](../apis/js-apis-keycode.md) | number | 按键的键码。 | + | keyText | string | 按键的键值。 | + | keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。 | + | deviceId | number | 触发当前按键的输入设备ID。 | + | metaKey | number | 按键发生时元键的状态,1表示按压态,0表示未按压态。 | + | timestamp | number | 按键发生时的时间戳。 | - 接口 @@ -43,21 +45,12 @@ ## KeySource枚举说明 -| 名称 | 描述 | -| ----------------------- | ---------- | -| Unknown | 输入设备类型未知。 | -| [KeyCode](#常用keycode说明) | 输入设备类型为键盘。 | - -## 常用KeyCode说明 -| 数值 | 行为 | 物理按键 | -| ---- | ---- | ---------- | -| 19 | 上 | 向上方向键。 | -| 20 | 下 | 向下方向键。 | -| 21 | 左 | 向左方向键。 | -| 22 | 右 | 向右方向键。 | -| 23 | 确定 | 遥控器的确认键。 | -| 66 | 确定 | 键盘的回车键。 | -| 160 | 确定 | 键盘的小键盘回车键。 | +| 名称 | 描述 | +| -------- | ---------- | +| Unknown | 输入设备类型未知。 | +| Keyboard | 输入设备类型为键盘。 | + + ## 示例