1# 按键事件 2 3按键事件指组件与键盘、遥控器等按键设备交互时触发的事件，适用于所有可获焦组件，例如Button。对于Text，Image等默认不可获焦的组件，可以设置focusable属性为true后使用按键事件。 4 5> **说明：** 6> 7> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9 10 11## 事件 12 13| 名称 | 支持冒泡 | 功能描述 | 14| ---------------------------------------- | ---- | ---------------------------------------- | 15| onKeyEvent(event: (event: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后，按键动作触发该回调，event返回值见[KeyEvent](#keyevent对象说明)介绍。 | 16 17 18## KeyEvent对象说明 19 20| 名称 | 类型 | 描述 | 21| ------------------------------------- | ---------------------------------------- | -------------------------- | 22| type | [KeyType](ts-appendix-enums.md#keytype) | 按键的类型。 | 23| [keyCode](../apis/js-apis-keycode.md#keycode) | number | 按键的键码。 | 24| keyText | string | 按键的键值。 | 25| keySource | [KeySource](ts-appendix-enums.md#keysource) | 触发当前按键的输入设备类型。 | 26| deviceId | number | 触发当前按键的输入设备ID。 | 27| metaKey | number | 按键发生时元键（即Windows键盘的WIN键、Mac键盘的Command键）的状态，1表示按压态，0表示未按压态。 | 28| timestamp | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 | 29| stopPropagation | () => void | 阻塞事件冒泡传递。 | 30| intentionCode<sup>10+</sup> | [IntentionCode](../apis/js-apis-intentioncode.md) | 按键对应的意图。 | 31 32 33## 示例 34 35```ts 36// xxx.ets 37@Entry 38@Component 39struct KeyEventExample { 40 @State text: string = '' 41 @State eventType: string = '' 42 43 build() { 44 Column() { 45 Button('KeyEvent') 46 .onKeyEvent((event?: KeyEvent) => { 47 if(event){ 48 if (event.type === KeyType.Down) { 49 this.eventType = 'Down' 50 } 51 if (event.type === KeyType.Up) { 52 this.eventType = 'Up' 53 } 54 this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText + '\nintentionCode:' + event.intentionCode 55 } 56 }) 57 Text(this.text).padding(15) 58 }.height(300).width('100%').padding(35) 59 } 60} 61``` 62 63  64
