鸿蒙Harmony应用开发—ArkTS声明式开发（组件快捷键事件）

开发者可以设置组件的自定义组合键，组合键的行为与click行为一致，组件在未获得焦点状态下也可以响应自定义组合键，每个组件可以设置多个组合键。

说明：

从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

keyboardShortcut

keyboardShortcut(value: string | FunctionKey, keys: Array<ModifierKey>, action?: () => void)

设置组件的自定义组合键。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	参数类型	必填	参数描述
value	string | FunctionKey	是	热键的单个字符（可以通过键盘输入的字符）或FunctionKey。
keys	Array<ModifierKey>	是	热键组合。
action	() => void	否	组合快捷键触发成功后的自定义事件回调。

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])
多个不同组件设置相同组合键	只响应结点树上的第一个组件，其它组件不响应快捷键。	Button('button1').keyboardShortcut('a',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[ModifierKey.CTRL])
无论组件是否获得焦点	只要窗口获焦快捷键就会响应	无
绑定单个快捷键时候，通过keyboardShortcut接口value值或者是keys值或两者都是空的情况下。 绑定多个快捷键的时候无法取消快捷键。	取消快捷键的设置	Button('button1').keyboardShortcut('',[ModifierKey.CTRL]) Button('button2').keyboardShortcut('a',[l]) Button('button3').keyboardShortcut('',[])
独立pipeline子窗口、主窗口共存的情况下	获焦的窗口响应快