鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件快捷鍵事件】
組件快捷鍵事件
開發(fā)者可以設(shè)置組件的自定義組合鍵，組合鍵的行為與click行為一致，組件在未獲得焦點狀態(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)容，則采用上角標單獨標記該內(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功能鍵。 |
快捷鍵使用注意事項
| 場景 | 快捷鍵處理邏輯 | 例子 |
|---|---|---|
| 所有支持onClick事件的組件 | 支持自定義組合鍵 | 無 |
| 自定義組合鍵要求 | 控制鍵Ctrl，Shift，Alt及它們的組合加上其它可輸入字符按鍵 | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) |
| 多個不同組件設(shè)置相同組合鍵 | 只響應(yīng)結(jié)點樹上的第一個組件、其它組件不響應(yīng)快捷鍵。 | Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[ModifierKey.CTRL]) |
| 無論組件是否獲得焦點 | 只要窗口獲焦快捷鍵就會響應(yīng) | 無 |
| 綁定單個快捷鍵時候，通過keyboardShortcut接口value值或者是keys值或兩者都是空的情況下。 綁定多個快捷鍵的時候無法取消快捷鍵。 | 取消快捷鍵的設(shè)置 | Button('button1').keyboardShortcut('',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[l]) Button('button3').keyboardShortcut('',[]) |
| 獨立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)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報投訴
-
鴻蒙
+關(guān)注
關(guān)注
60文章
2862瀏覽量
45365
發(fā)布評論請先 登錄
相關(guān)推薦
熱點推薦
華秋DFM軟件丨操作教程——自定義快捷鍵篇
，關(guān)于 華秋DFM軟件的快捷鍵要如何自定義設(shè)置和應(yīng)用 。讓你徹底擺脫此類沖突困擾，沉浸式體驗華秋DFM的操作流程。【第一步】華秋DFM軟件的快捷鍵功能設(shè)置入口：在 菜單欄點擊“設(shè)置-快捷鍵
發(fā)表于 08-13 16:29
AD、Allegro、Pads的快捷鍵有什么不同
在高速迭代的電子設(shè)計領(lǐng)域，快捷鍵是工程師與EDA工具對話的核心語言，縱觀EDA工具，AD的視覺化交互、Allegro的深度可編程性、Pads的無膜命令——三種理念催生了截然不同的操作邏輯，那么它們的快捷鍵操作是否會有些不同?
ArkUI-X跨平臺應(yīng)用改造指南
ArkUI-X跨平臺應(yīng)用改造指南
現(xiàn)狀與訴求
隨著 HarmonyOS Next 5.0 版本正式發(fā)布，眾多開發(fā)者基于 ArkTS 語言為 HarmonyOS Next 系統(tǒng)
發(fā)表于 06-16 23:05
鴻蒙5開發(fā)寶藏案例分享---平板開發(fā)實踐
展示更多內(nèi)容（如分欄/網(wǎng)格布局）
形態(tài)靈活 ：橫豎屏旋轉(zhuǎn) + 自由窗口 → 必須做動態(tài)布局適配
交互擴展 ：支持鍵鼠 → 需增加懸浮/焦點/快捷鍵邏輯
**?**工程配置第一步
在<
發(fā)表于 06-12 15:49
使用DevEcoStudio 開發(fā)、編譯鴻蒙 NEXT_APP 以及使用中文插件
的一站式集成開發(fā)環(huán)境（IDE），專為鴻蒙操作系統(tǒng)（HarmonyOS Next）應(yīng)用和服務(wù)開發(fā)設(shè)計 DevEco Studio，掌握基本操作和開發(fā)
發(fā)表于 06-11 17:18
ArkUI-x跨平臺Bridge最佳實踐
;一碼三平臺\"
前面講到的bridge主要是解決開發(fā)者在進行ArkTS代碼開發(fā)時，需要使用的鴻蒙API不
發(fā)表于 06-10 23:06
Kuikly鴻蒙版正式開源 —— 揭秘卓越性能適配之旅
端的基礎(chǔ)能力和設(shè)施，包括豐富的跨端組件，完善的調(diào)試、構(gòu)建、發(fā)布、監(jiān)控配套工具鏈，穩(wěn)定性監(jiān)控能力等。
Kuikly框架優(yōu)勢：
一碼五端，支持Android、iOS、鴻蒙、Web、小程序5
發(fā)表于 06-04 16:46
鴻蒙5開發(fā)寶藏案例分享---一多開發(fā)實例（長視頻）
/ # 手機增強功能
└─ pc/ # 鍵盤快捷鍵
?** 更多實戰(zhàn)案例推薦**
案例1：電商類應(yīng)用（雙十一專題）
手機 ：豎版商品瀑布流
平板 ：左側(cè)分類導(dǎo)航+右側(cè)商品
PC ：三欄式布局（分類
發(fā)表于 06-03 15:58
AD-PCB快捷鍵總結(jié)
1. PCB設(shè)計快捷鍵（單次按鍵）
單次按鍵是指按下該鍵并放開。
1-01 +在PCB電氣層之間切換（小鍵盤上的+）。在交互布線的過程中，按此鍵則換層并自動添加過孔。這很常用。
1-02 Q
發(fā)表于 05-26 15:10
AD軟件快捷鍵設(shè)置和導(dǎo)入方法
，由于Protel在國內(nèi)有廣大的使用群體基礎(chǔ)，因此，AD的使用者數(shù)量在國內(nèi)是最多的。近來后臺有不少朋友來詢問AD快捷鍵設(shè)置的問題，在學(xué)習(xí)的時候，考慮到跨軟件使用，已經(jīng)將AD、Cadence和Pads
發(fā)表于 03-26 10:03
開源啦?。。』?b class='flag-5'>鴻蒙ArkTS封裝的圖表組件《McCharts》，大家快來一起共創(chuàng)
的地方請大家高抬貴手，寬容一下，謝謝。
這次主要是給大家?guī)硪粋€重磅消息，就是我自己使用鴻蒙ArkTS語法開發(fā)的圖表組件今日正式開源了。為什么？原因有兩點吧！
發(fā)表于 03-15 15:21
工商網(wǎng)監(jiān)
評論