鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件快捷鍵事件】
組件快捷鍵事件
開發(fā)者可以設(shè)置組件的自定義組合鍵，組合鍵的行為與click行為一致，組件在未獲得焦點(diǎn)狀態(tài)下也可以響應(yīng)自定義組合鍵，每個組件可以設(shè)置多個組合鍵。
說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 10開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
接口
keyboardShortcut(value: string | [FunctionKey], keys: Array<[ModifierKey]>)
| 參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
|---|---|---|---|
| value | string | [FunctionKey] | 是 |
| keys | Array<[ModifierKey]> | 是 | 熱鍵組合。 |
ModifierKey
| 名稱 | 描述 |
|---|---|
| CTRL | 表示鍵盤上Ctrl鍵。 |
| SHIFT | 表示鍵盤上Shift鍵。 |
| ALT | 表示鍵盤上Alt鍵。 |
FunctionKey
| 名稱 | 描述 |
|---|---|
| ESC | 表示鍵盤上ESC功能鍵。 |
| F1 | 表示鍵盤上F1功能鍵。 |
| F2 | 表示鍵盤上F2功能鍵。 |
| F3 | 表示鍵盤上F3功能鍵。 |
| F4 | 表示鍵盤上F4功能鍵。 |
| F5 | 表示鍵盤上F5功能鍵。 |
| F6 | 表示鍵盤上F6功能鍵。 |
| F7 | 表示鍵盤上F7功能鍵。 |
| F8 | 表示鍵盤上F8功能鍵。 |
| F9 | 表示鍵盤上F9功能鍵。 |
| F10 | 表示鍵盤上F10功能鍵。 |
| F11 | 表示鍵盤上F11功能鍵。 |
| F12 | 表示鍵盤上F12功能鍵。 |
快捷鍵使用注意事項(xiàng)
| 場景 | 快捷鍵處理邏輯 | 例子 |
|---|---|---|
| 所有支持onClick事件的組件 | 支持自定義組合鍵 | 無 |
| 自定義組合鍵要求 | 控制鍵Ctrl，Shift，Alt及它們的組合加上其它可輸入字符按鍵 | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) |
| 多個不同組件設(shè)置相同組合鍵 | 只響應(yīng)結(jié)點(diǎn)樹上的第一個組件、其它組件不響應(yīng)快捷鍵。 | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[ModifierKey.CTRL]) |
| 無論組件是否獲得焦點(diǎn) | 只要窗口獲焦快捷鍵就會響應(yīng) | 無 |
| 綁定單個快捷鍵時候，通過keyboardShortcut接口value值或者是keys值或兩者都是空的情況下。 綁定多個快捷鍵的時候無法取消快捷鍵。 | 取消快捷鍵的設(shè)置 | Button('button1').keyboardShortcut('',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[l]) Button('button3').keyboardShortcut('',[]) |
| 獨(dú)立pipeline子窗口、主窗口共存的情況下 | 獲焦的窗口響應(yīng)快捷鍵 | 無 |
| keyboardShortcut接口中的keys命令中ctrl、shift、alt | 不區(qū)分左右鍵都響應(yīng) | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL, ModifierKey.ALT]) |
| keyboardShortcut接口中的value單個字符 | 不區(qū)分大小寫都響應(yīng) | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('A',[ModifierKey.CTRL]) |
| 快捷鍵的響應(yīng) | 所有快捷鍵down的狀態(tài)下響應(yīng)、且連續(xù)響應(yīng) | 無 |
| 隱藏組件 | 響應(yīng)快捷鍵 | 無 |
| disable狀態(tài)組件 | 不響應(yīng)快捷鍵 | 無 |
| 1. 組件的組合鍵(包括系統(tǒng)預(yù)定義快捷鍵)相同時。 2. 接口參數(shù)value有多個字符時。 3. 接口參數(shù)keys有重復(fù)的控制鍵時。 | 這幾種情況不綁定組合鍵, 先前綁定的組合鍵仍然有效 | Button('button1').keyboardShortcut('c',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('ab',[ModifierKey.CTRL]) Button('button3').keyboardShortcut('ab',[ModifierKey.CTRL,ModifierKey.CTRL]) |
系統(tǒng)已有組合鍵
| 快捷鍵 | 組件HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 |
|---|---|
| Ctrl + C | [Image]、[TextInput]、[TextArea] |
| Ctrl+ A | [TextInput]、[TextArea] |
| Ctrl+ V | [TextInput]、[TextArea] |
| Ctrl+ X | [TextInput]、[TextArea] |
| Shift + 方向鍵 | [TextInput]、[TextArea] |
| Ctrl+ Shift+ Z | [TextInput]、[TextArea] |
| Ctrl+ Z | [TextInput]、[TextArea] |
| Ctrl+ Y | [TextInput]、[TextArea] |
| 方向鍵、回車鍵 | [TextInput]、[TextArea] |
| TAB鍵 | [TextInput]、[TextArea] |
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報(bào)投訴
-
鴻蒙
+關(guān)注
關(guān)注
57文章
2393瀏覽量
43079
發(fā)布評論請先 登錄
相關(guān)推薦
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件內(nèi)容填充方式】
用于決定在組件的寬高動畫過程中，如何將動畫最終的組件內(nèi)容繪制在組件上。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【安全區(qū)域】
通過expandSafeArea屬性支持組件擴(kuò)展其安全區(qū)域。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件內(nèi)容模糊】 通用屬性
為當(dāng)前組件提供內(nèi)容模糊能力。 value: 內(nèi)容模糊樣式。模糊樣式由模糊半徑、蒙版顏色、蒙版透明度、飽和度、亮度五個參數(shù)組成。 options: 可選參數(shù)，內(nèi)容模糊選項(xiàng)。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【分布式遷移標(biāo)識】 通用屬性
組件的分布式遷移標(biāo)識，指明了該組件在分布式遷移場景下可以將特定狀態(tài)恢復(fù)到對端設(shè)備。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【多態(tài)樣式】 通用屬性
設(shè)置組件不同狀態(tài)的樣式。 從API version 9開始，該接口支持在ArkTS卡片中使用。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件標(biāo)識】 通用屬性
id為組件的唯一標(biāo)識，在整個應(yīng)用內(nèi)唯一。本模塊提供組件標(biāo)識相關(guān)接口，可以獲取指定id組件的屬性，也提供向指定id組件發(fā)送事件的功能。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【菜單控制】 通用屬性
為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項(xiàng)，可通過長按、點(diǎn)擊或鼠標(biāo)右鍵觸發(fā)。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【形狀裁剪】 通用屬性
參數(shù)為相應(yīng)類型的組件，按指定的形狀對當(dāng)前組件進(jìn)行裁剪；參數(shù)為boolean類型時，設(shè)置是否按照父容器邊緣輪廓進(jìn)行裁剪。 默認(rèn)值：false 從API version 9開始，該接口支持在Ark
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【顯隱控制】 通用屬性
控制當(dāng)前組件顯示或隱藏。注意，即使組件處于隱藏狀態(tài)，在頁面刷新時仍存在重新創(chuàng)建過程，因此當(dāng)對性能有嚴(yán)格要求時建議使用[條件渲染]代替。 默認(rèn)值：Visibility.Visible 從API version 9開始，該接口支持在
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件區(qū)域變化事件】
組件區(qū)域變化事件指組件顯示的尺寸、位置等發(fā)生變化時觸發(fā)的事件。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件可見區(qū)域變化事件】
組件可見區(qū)域變化事件是組件在屏幕中的顯示區(qū)域面積變化時觸發(fā)的事件，提供了判斷組件是否完全或部分顯示在屏幕中的能力，適用于廣告曝光埋點(diǎn)之類的場景。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【按鍵事件】
按鍵事件指組件與鍵盤、遙控器等按鍵設(shè)備交互時觸發(fā)的事件，適用于所有可獲焦組件，例如Button。對于Text，Image等默認(rèn)不可獲焦的組件，可以設(shè)置focusable屬性為true后使用按鍵事件。
鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【焦點(diǎn)事件】
焦點(diǎn)事件指頁面焦點(diǎn)在可獲焦組件間移動時觸發(fā)的事件，組件可使用焦點(diǎn)事件來處理相關(guān)邏輯。
工商網(wǎng)監(jiān)
評論