Kbd
快捷键提示:菜单项右侧、提示条里的按键。keys 吃键位写法 Mod+Shift+1——Mod 是主修饰键(mac 上 ⌘、别处 Ctrl),键名用 KeyboardEvent.code 去掉前缀的形式(KeyA → A、Equal、ArrowUp)。mac 上按系统菜单次序 ⌃⌥⇧⌘ 紧挨着排,别处用 + 连接。也可以不给 keys、直接把文字放进插槽。
平台在挂载后才判断:服务端认不出平台,首帧按「不是 mac」渲染才能与服务端一致,mac 上随后换成符号。字号取所在文字的 0.8em,放进不同尺寸档的菜单会跟着缩放。
基础
按当前平台渲染
撤销 Ctrl+Z重做 Ctrl+Shift+Z放大 Ctrl+=取消 Esc任意文字 F1
指定平台与 formatChord
mac 显式指定平台;提示条、aria-label 这类只能放纯文本的地方用 formatChord(chord, mac?),与 XKbd 同一套规则(不传 mac 时现场判断)。
mac 与其他平台对照
| 键位写法 | mac | 其他平台 | formatChord(…, false) |
|---|---|---|---|
Mod+S | ⌘S | Ctrl+S | Ctrl+S |
Mod+Shift+1 | ⇧⌘1 | Ctrl+Shift+1 | Ctrl+Shift+1 |
Alt+Mod+ArrowUp | ⌥⌘↑ | Alt+Ctrl+↑ | Alt+Ctrl+↑ |
Shift+Backspace | ⇧⌫ | Shift+⌫ | Shift+⌫ |
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
keys | string | undefined | undefined | 键位写法,如 `Mod+Shift+1`(`Mod` 在 mac 上是 ⌘、别处是 Ctrl);不给就渲染插槽里的文字 |
mac | boolean | undefined | undefined | 按哪个平台显示;缺省挂载后自动判断 |
Slots
| 插槽 | 说明 |
|---|---|
default | — |