Key 键盘按键

INFO

用于展示键盘快捷键，自动适配 Mac/Windows 显示。

基本语法

<c-key code="K" cmd></c-key>
<c-key text="自定义文本"></c-key>

参数说明

参数	类型	默认值	说明
code	string	无	按键代码（如 K、Enter、Space）
text	string	无	自定义显示文本（优先级最高）
cmd	boolean	false	Command/Ctrl 键
ctrl	boolean	false	Control 键（Mac 上显示 ⌃）
shift	boolean	false	Shift 键
alt	boolean	false	Alt/Option 键

平台自适应

INFO

组件会自动检测用户系统，显示对应的按键符号

参数	Mac	Windows/Linux
cmd	⌘	Ctrl
ctrl	⌃	Ctrl
shift	⇧	Shift
alt	⌥	Alt

使用示例

示例 1：搜索快捷键

按 <c-key code="K" cmd></c-key> 打开搜索框。

效果（Mac）：按 ⌘K 打开搜索框。效果（Win）：按 Ctrl+K 打开搜索框。

示例 2：组合键

保存：<c-key code="S" cmd></c-key><br>
撤销：<c-key code="Z" cmd></c-key><br>
全选：<c-key code="A" cmd></c-key>

示例 3：带 Shift 的组合键

新建标签页：<c-key code="T" cmd></c-key><br>
重新打开标签页：<c-key code="T" cmd shift></c-key>

示例 4：自定义文本

按 <c-key text="Enter"></c-key> 确认，<c-key text="Esc"></c-key> 取消。

示例 5：完整快捷键说明

<table>
  <tr><td>打开搜索</td><td><c-key code="K" cmd></c-key></td></tr>
  <tr><td>切换主题</td><td><c-key code="D" cmd shift></c-key></td></tr>
  <tr><td>返回顶部</td><td><c-key text="Home"></c-key></td></tr>
</table>

使用效果