@xwink/ui

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⌘SCtrl+SCtrl+S
Mod+Shift+1⇧⌘1Ctrl+Shift+1Ctrl+Shift+1
Alt+Mod+ArrowUp⌥⌘↑Alt+Ctrl+↑Alt+Ctrl+↑
Shift+Backspace⇧⌫Shift+⌫Shift+⌫

API

Props

名称类型默认值说明
keysstring | undefinedundefined键位写法,如 `Mod+Shift+1`(`Mod` 在 mac 上是 ⌘、别处是 Ctrl);不给就渲染插槽里的文字
macboolean | undefinedundefined按哪个平台显示;缺省挂载后自动判断

Slots

插槽说明
default—