Hotkey 快捷键Hotkey · Kbd

Hotkey 让用户录制一个组合键，用在“自定义快捷键”这类设置里。Kbd 是单个键帽，用来在文档、菜单和提示里展示按键。

录制

点击或按 Enter / 空格开始录制，然后直接按下组合键。修饰键按下即显示，按下一个非修饰键后完成。Esc、Tab 或失焦取消，原来的值不变。

全局搜索

⌘K当前：Command + K

点击后按下新的组合键

未设置

点击录制未设置

⌃B当前：Control + B

⌥⇧F当前：Option + Shift + F

⌘↩当前：Command + 回车

尚未绑定未设置

⌘S当前：Command + S

value 是用 + 连接的按键名（KeyboardEvent.key 的写法），空字符串表示未设置。onChange 的第二个参数是拆开的数组。组件只负责录制，不负责监听和触发快捷键。

⌘⇧K当前：Command + Shift + K

value：Meta+Shift+K

用 k 传按键名会自动换成符号（⌘ ⇧ ⌥ ⌃ ↩ …），并带上读屏能读出的名称；也可以直接写 children。

⌘⇧⌥⌃↩⌫⇥EscSpace↑↓←→

AAA

按 ⌘ K 打开命令面板，按 Esc 关闭。

属性	类型	默认值	说明
`value`	`string`	—	组合键（受控），用 + 连接，如 "Meta+Shift+K"；空字符串表示未设置。
`defaultValue`	`string`	`''`	初始组合键（非受控）。
`onChange`	`(value: string, keys: string[]) => void`	—	录到新的组合键时触发。
`placeholder`	`string`	`'点击录制'`	未设置时的提示。
`recordingText`	`string`	`'按下组合键…'`	录制中的提示。
`size`	`'sm' \| 'md' \| 'lg'`	`'md'`	尺寸。
`disabled`	`boolean`	—	禁用。

属性	类型	默认值	说明
`k`	`string`	—	按键名（Meta、Shift、Enter、ArrowUp、K…）：自动换成符号并带可读名称。
`size`	`'sm' \| 'md' \| 'lg'`	`'md'`	高度 20 / 默认 / 28。
`children`	`ReactNode`	—	不传 k 时直接显示的内容。