鴻蒙ArkTS聲明式開發：跨平臺支持列表【按鍵事件】

按鍵事件

按鍵事件指組件與鍵盤、遙控器等按鍵設備交互時觸發的事件，適用于所有可獲焦組件，例如Button。對于Text，Image等默認不可獲焦的組件，可以設置focusable屬性為true后使用按鍵事件。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

事件

名稱	支持冒泡	功能描述
onKeyEvent(event: (event?: KeyEvent) => void)	是	綁定該方法的組件獲焦后，按鍵動作觸發該回調，event返回值見[KeyEvent]介紹。

KeyEvent對象說明

名稱	類型	描述
type	[KeyType]	按鍵的類型。
[keyCode]	number	按鍵的鍵碼。
keyText	string	按鍵的鍵值。
keySource	[KeySource]	觸發當前按鍵的輸入設備類型。
deviceId	number	觸發當前按鍵的輸入設備ID。
metaKey	number	按鍵發生時元鍵（即Windows鍵盤的WIN鍵、Mac鍵盤的Command鍵）的狀態，1表示按壓態，0表示未按壓態。
timestamp	number	按鍵發生時的時間戳。
stopPropagation	() => void	阻塞事件冒泡傳遞。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151547.png

示例

// xxx.ets
@Entry
@Component
struct KeyEventExample {
  @State text: string = ''
  @State eventType: string = ''

  build() {
    Column() {
      Button('KeyEvent')
        .onKeyEvent((event: KeyEvent) = > {
          if (event.type === KeyType.Down) {
            this.eventType = 'Down'
          }
          if (event.type === KeyType.Up) {
            this.eventType = 'Up'
          }
          this.text = 'KeyType:' + this.eventType + 'nkeyCode:' + event.keyCode + 'nkeyText:' + event.keyText
        })
      Text(this.text).padding(15)
    }.height(300).width('100%').padding(35)
  }
}