鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【組件快捷鍵事件】
組件快捷鍵事件
開發(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)已有組合鍵
| 快捷鍵 | 組件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)注
60文章
2619瀏覽量
44042
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
熱點(diǎn)推薦
ArkUI-X跨平臺(tái)應(yīng)用改造指南
ArkUI-X跨平臺(tái)應(yīng)用改造指南
現(xiàn)狀與訴求
隨著 HarmonyOS Next 5.0 版本正式發(fā)布，眾多開發(fā)者基于 ArkTS 語(yǔ)言為 HarmonyOS Next 系統(tǒng)
發(fā)表于 06-16 23:05
鴻蒙5開發(fā)寶藏案例分享---平板開發(fā)實(shí)踐
展示更多內(nèi)容（如分欄/網(wǎng)格布局）
形態(tài)靈活 ：橫豎屏旋轉(zhuǎn) + 自由窗口 → 必須做動(dòng)態(tài)布局適配
交互擴(kuò)展 ：支持鍵鼠 → 需增加懸浮/焦點(diǎn)/快捷鍵邏輯
**?**工程配置第一步
在<
發(fā)表于 06-12 15:49
使用DevEcoStudio 開發(fā)、編譯鴻蒙 NEXT_APP 以及使用中文插件
的一站式集成開發(fā)環(huán)境（IDE），專為鴻蒙操作系統(tǒng)（HarmonyOS Next）應(yīng)用和服務(wù)開發(fā)設(shè)計(jì) DevEco Studio，掌握基本操作和開發(fā)
發(fā)表于 06-11 17:18
ArkUI-x跨平臺(tái)Bridge最佳實(shí)踐
;一碼三平臺(tái)\"
前面講到的bridge主要是解決開發(fā)者在進(jìn)行ArkTS代碼開發(fā)時(shí)，需要使用的鴻蒙API不
發(fā)表于 06-10 23:06
Kuikly鴻蒙版正式開源 —— 揭秘卓越性能適配之旅
端的基礎(chǔ)能力和設(shè)施，包括豐富的跨端組件，完善的調(diào)試、構(gòu)建、發(fā)布、監(jiān)控配套工具鏈，穩(wěn)定性監(jiān)控能力等。
Kuikly框架優(yōu)勢(shì)：
一碼五端，支持Android、iOS、鴻蒙、Web、小程序5
發(fā)表于 06-04 16:46
鴻蒙5開發(fā)寶藏案例分享---一多開發(fā)實(shí)例（長(zhǎng)視頻）
/ # 手機(jī)增強(qiáng)功能
└─ pc/ # 鍵盤快捷鍵
?** 更多實(shí)戰(zhàn)案例推薦**
案例1：電商類應(yīng)用（雙十一專題）
手機(jī) ：豎版商品瀑布流
平板 ：左側(cè)分類導(dǎo)航+右側(cè)商品
PC ：三欄式布局（分類
發(fā)表于 06-03 15:58
AD-PCB快捷鍵總結(jié)
1. PCB設(shè)計(jì)快捷鍵（單次按鍵）
單次按鍵是指按下該鍵并放開。
1-01 +在PCB電氣層之間切換（小鍵盤上的+）。在交互布線的過程中，按此鍵則換層并自動(dòng)添加過孔。這很常用。
1-02 Q
發(fā)表于 05-26 15:10
ArkUI-X跨平臺(tái)框架接入指南
ArkUI跨平臺(tái)框架(ArkUI-X)進(jìn)一步將ArkUI開發(fā)框架擴(kuò)展到了多個(gè)OS平臺(tái)：目前支持OpenHarmony、Android、 iO
發(fā)表于 05-18 18:21
AD軟件快捷鍵設(shè)置和導(dǎo)入方法
，由于Protel在國(guó)內(nèi)有廣大的使用群體基礎(chǔ)，因此，AD的使用者數(shù)量在國(guó)內(nèi)是最多的。近來后臺(tái)有不少朋友來詢問AD快捷鍵設(shè)置的問題，在學(xué)習(xí)的時(shí)候，考慮到跨軟件使用，已經(jīng)將AD、Cadence和Pads
發(fā)表于 03-26 10:03
開源啦！！！基于鴻蒙ArkTS封裝的圖表組件《McCharts》，大家快來一起共創(chuàng)
的地方請(qǐng)大家高抬貴手，寬容一下，謝謝。
這次主要是給大家?guī)硪粋€(gè)重磅消息，就是我自己使用鴻蒙ArkTS語(yǔ)法開發(fā)的圖表組件今日正式開源了。為什么？原因有兩點(diǎn)吧！
發(fā)表于 03-15 15:21
ArkTS開發(fā)指南優(yōu)化上新
ArkTS是HarmonyOS應(yīng)用開發(fā)的官方高級(jí)語(yǔ)言，提供了聲明式UI范式、狀態(tài)管理、渲染控制等相應(yīng)能力，讓開發(fā)者能夠以更簡(jiǎn)潔、更自然的方式
SOLIDWORKS教育版支持多種快捷鍵和自定義工具
，SOLIDWORKS教育版不僅繼承了專業(yè)版的核心功能，還特別注重提升用戶體驗(yàn)，通過支持多種快捷鍵和高度自定義的工具，大大地提高了學(xué)習(xí)效率與創(chuàng)造力。
鴻蒙原生應(yīng)用元服務(wù)開發(fā)-倉(cāng)頡ArkTS相互操作（一）
在 OpenHarmony 系統(tǒng)上，ArkTS 具備完整廣泛的生態(tài)，為復(fù)用 ArkTS 生態(tài)，倉(cāng)頡支持與 ArkTS 高效跨語(yǔ)言互通。
倉(cāng)頡
發(fā)表于 07-31 17:43
工商網(wǎng)監(jiān)
評(píng)論