Props

名称	类型	默认值	说明
keys	string	-	必填。要呈现的键盘快捷键，按键之间用 + 分隔，例如 "mod+k"、"shift+plus"。每个分段渲染成一枚按键徽章，分段周围的空格会被忽略，无法识别的分段按大写显示。

按键名称

写法	显示	朗读
mod	⌘ / Ctrl	Command（Apple 平台）/ Control
ctrl	⌃	Control
alt	⌥	Alt
shift	⇧	Shift
enter / return	↵	Enter
backspace	⌫	Backspace
tab	⇥	Tab
escape / esc	Esc	Escape
up	↑	Up arrow
down	↓	Down arrow
left	←	Left arrow
right	→	Right arrow
plus	+	Plus

表中没有列出的分段按大写原样显示，朗读时读同一段文字，例如 f1 显示为 F1。

无障碍

根元素带有 role="img"，它的 aria-label 由各按键的朗读词拼接而成，例如 keys="mod+k" 得到 “Control + K”。徽章本身带有 aria-hidden="true"，因为它们画出的字形对屏幕阅读器没有意义。role 和 aria-label 由组件计算，显式传入的同名属性会被忽略，其他 aria-* 属性可以正常传入。

原生属性

根元素为 <span>。

以下内容传入根元素：

• HTML 属性。
• aria-* 属性（role 和 aria-label 除外，见上一节）。
• data-* 属性。
• class。
• style。