組件快捷鍵事件

開發(fā)者可以設(shè)置組件的自定義組合鍵，組合鍵的行為與click行為一致，組件在未獲得焦點(diǎn)狀態(tài)下也可以響應(yīng)自定義組合鍵，每個(gè)組件可以設(shè)置多個(gè)組合鍵。

說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(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ù)類型	必填	參數(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)

場(chǎng)景	快捷鍵處理邏輯	例子
所有支持onClick事件的組件	支持自定義組合鍵	無
自定義組合鍵要求	控制鍵Ctrl，Shift，Alt及它們的組合加上其它可輸入字符按鍵	Button('button1').keyboardShortcut('a',[ModifierKey.CTRL])
多個(gè)不同組件設(shè)置相同組合鍵	只響應(yīng)結(jié)點(diǎn)樹上的第一個(gè)組件、其它組件不響應(yīng)快捷鍵。	Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[ModifierKey.CTRL])
無論組件是否獲得焦點(diǎn)	只要窗口獲焦快捷鍵就會(huì)響應(yīng)	無
綁定單個(gè)快捷鍵時(shí)候，通過keyboardShortcut接口value值或者是keys值或兩者都是空的情況下。綁定多個(gè)快捷鍵的時(shí)候無法取消快捷鍵。	取消快捷鍵的設(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單個(gè)字符	不區(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ù)定義快捷鍵)相同時(shí)。 2. 接口參數(shù)value有多個(gè)字符時(shí)。 3. 接口參數(shù)keys有重復(fù)的控制鍵時(shí)。	這幾種情況不綁定組合鍵, 先前綁定的組合鍵仍然有效	Button('button1').keyboardShortcut('c',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('ab',[ModifierKey.CTRL]) Button('button3').keyboardShortcut('ab',[ModifierKey.CTRL,ModifierKey.CTRL])

系統(tǒng)已有組合鍵

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

快捷鍵	組件`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)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴

鴻蒙

鴻蒙

+關(guān)注

關(guān)注
57

文章
2339

瀏覽量
42805

評(píng)論

相關(guān)推薦

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件內(nèi)容填充方式】

用于決定在組件的寬高動(dòng)畫過程中，如何將動(dòng)畫最終的組件內(nèi)容繪制在組件上。

發(fā)表于 06-15 09:11 ?1141次閱讀

<b class='flag-5'>鴻蒙</b><b class='flag-5'>ArkTS</b><b class='flag-5'>聲明</b><b class='flag-5'>式</b><b class='flag-5'>開發(fā)</b>：<b class='flag-5'>跨</b><b class='flag-5'>平臺(tái)</b><b class='flag-5'>支持</b><b class='flag-5'>列表</b>【<b class='flag-5'>組件</b>內(nèi)容填充方式】

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件內(nèi)容模糊】通用屬性

為當(dāng)前組件提供內(nèi)容模糊能力。 value: 內(nèi)容模糊樣式。模糊樣式由模糊半徑、蒙版顏色、蒙版透明度、飽和度、亮度五個(gè)參數(shù)組成。 options: 可選參數(shù)，內(nèi)容模糊選項(xiàng)。

發(fā)表于 06-10 18:32 ?624次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【分布式遷移標(biāo)識(shí)】通用屬性

組件的分布式遷移標(biāo)識(shí)，指明了該組件在分布式遷移場(chǎng)景下可以將特定狀態(tài)恢復(fù)到對(duì)端設(shè)備。

發(fā)表于 06-07 21:15 ?390次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【多態(tài)樣式】通用屬性

設(shè)置組件不同狀態(tài)的樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。

發(fā)表于 06-07 09:48 ?388次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件標(biāo)識(shí)】通用屬性

id為組件的唯一標(biāo)識(shí)，在整個(gè)應(yīng)用內(nèi)唯一。本模塊提供組件標(biāo)識(shí)相關(guān)接口，可以獲取指定id組件的屬性，也提供向指定id組件發(fā)送事件的功能。

發(fā)表于 06-06 15:51 ?379次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【菜單控制】通用屬性

為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項(xiàng)，可通過長(zhǎng)按、點(diǎn)擊或鼠標(biāo)右鍵觸發(fā)。

發(fā)表于 06-06 09:17 ?655次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【形狀裁剪】通用屬性

參數(shù)為相應(yīng)類型的組件，按指定的形狀對(duì)當(dāng)前組件進(jìn)行裁剪；參數(shù)為boolean類型時(shí)，設(shè)置是否按照父容器邊緣輪廓進(jìn)行裁剪。默認(rèn)值：false 從API version 9開始，該接口支持在Ark

發(fā)表于 06-04 15:22 ?459次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【顯隱控制】通用屬性

控制當(dāng)前組件顯示或隱藏。注意，即使組件處于隱藏狀態(tài)，在頁面刷新時(shí)仍存在重新創(chuàng)建過程，因此當(dāng)對(duì)性能有嚴(yán)格要求時(shí)建議使用[條件渲染]代替。默認(rèn)值：Visibility.Visible 從API version 9開始，該接口支持在

發(fā)表于 06-03 14:46 ?586次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件區(qū)域變化事件】

組件區(qū)域變化事件指組件顯示的尺寸、位置等發(fā)生變化時(shí)觸發(fā)的事件。

發(fā)表于 05-30 11:41 ?365次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件可見區(qū)域變化事件】

組件可見區(qū)域變化事件是組件在屏幕中的顯示區(qū)域面積變化時(shí)觸發(fā)的事件，提供了判斷組件是否完全或部分顯示在屏幕中的能力，適用于廣告曝光埋點(diǎn)之類的場(chǎng)景。

發(fā)表于 05-30 10:37 ?395次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【按鍵事件】

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

發(fā)表于 05-28 18:12 ?856次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【焦點(diǎn)事件】

焦點(diǎn)事件指頁面焦點(diǎn)在可獲焦組件間移動(dòng)時(shí)觸發(fā)的事件，組件可使用焦點(diǎn)事件來處理相關(guān)邏輯。

發(fā)表于 05-27 22:17 ?322次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【觸摸事件】

當(dāng)手指在組件上按下、滑動(dòng)、抬起時(shí)觸發(fā)。

發(fā)表于 05-27 09:34 ?479次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【點(diǎn)擊事件】

組件被點(diǎn)擊時(shí)觸發(fā)的事件。

發(fā)表于 05-26 21:25 ?695次閱讀

鴻蒙ArkTS的起源和簡(jiǎn)介

新的聲明式開發(fā)范式，基于Skia的自繪制引擎構(gòu)建可跨平臺(tái)的獨(dú)立的渲染能力。這是一種較為創(chuàng)新的方案，不過也有幾點(diǎn)不足： Dart語言生態(tài)。盡管

發(fā)表于 01-16 16:23