项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。

EtKeyHint · 键帽文本 ​

快捷键文本的平台符号化:mod 在 macOS 印 ⌘,在 Windows/Linux 印 Ctrl。

紧凑 24
⌘⇧Z⌘⇧ZCtrl+F1
默认 32
⌘⇧Z⌘⇧ZCtrl+F1
宽松 40
⌘⇧Z⌘⇧ZCtrl+F1

API ​

import { EtKeyHint } from '@wil-works/evoke-tools-ui'公共工具命令原子件

Props

名称类型默认说明
comboString''规范组合键串:'mod+shift+z'(未规范化也接受,构造期即校验键名合法性)
platformString'auto'平台:'auto' 走运行时识别;测试与文档可钉死 'mac' / 'win'

键盘 · 可访问名 · 密度

键盘不接管按键
可访问名 无 ARIA 属性(原生语义)
密度--et-density-caption-font

行为 ​

  • combo 为空时键帽文本为空串。
  • 渲染 <kbd> 元素,类名带平台档(et-keyhint--{platform})。
  • 暴露 text(当前展示串)。
  • 修饰键同义词(cmd / meta / super / opt …)归并后展示,不硬编码平台字符。

令牌与门禁 ​

  • 键名字符表在 runtime/keys,formatCombo 是唯一定制点。
  • G6:平台符号由代码生成,禁止在模板里手拼平台键字符。