HotKeys 设计文档
声明一组键盘快捷键组合并绑定 keydown 监听（默认全局 document.body，可局部），命中触发回调，并渲染键位提示（严格对齐 Semi：div.cd-hotKeys > span > span.-content + span.-split，用 span 非 kbd，键位原样渲染不做大小写/平台符号转换）。修饰键精确匹配 + 普通键用 event.code（物理键位，规避输入法/大小写，Semi 原生设计）。mergeMetaCtrl 为死 prop（严格对齐 Semi：声明但不生效，Meta/Ctrl 仍严格区分）。
← API 文档使用建议
声明一组键盘快捷键组合并绑定 keydown 监听（默认全局 document.body，可局部），命中触发回调，并渲染键位提示（严格对齐 Semi：div.cd-hotKeys > span > span.-content + span.-split，用 span 非 kbd，键位原样渲染不做大小写/平台符号转换）。修饰键精确匹配 + 普通键用 event.code（物理键位，规避输入法/大小写，Semi 原生设计）。mergeMetaCtrl 为死 prop（严格对齐 Semi：声明但不生效，Meta/Ctrl 仍严格区分）。
Accessibility
- DOM 严格对齐 Semi：键位用 span（非 kbd）承载，无 aria-keyshortcuts、无 aria-hidden 分隔符
- 匹配用 event.code 物理键位，规避输入法/大小写/Shift
- 对比度：键位块文字/背景 ≥4.5:1
- 提示纯展示无焦点；监听不引入焦点陷阱
设计变量
变量 | 默认值 | 用法 |
|---|---|---|
| --cd-color-hotkeys-bg | var(--cd-color-fill-0) | 单个键位块背景（对齐 Semi fill-0） |
| --cd-color-hotkeys-split | var(--cd-color-text-0) | 键位之间 + 分隔符颜色（对齐 Semi text-0） |
| --cd-color-hotkeys-text | var(--cd-color-text-2) | 键位块内文字/符号颜色（对齐 Semi text-2） |
显示第 1 条-第 3 条，共 3 条
- 1