iter(g237): 新增 kbd 键盘按键标记,键帽样式支持单键与组合键(74 组件)

This commit is contained in:
HIsheR
2026-10-26 21:30:52 +08:00
parent 55980c5ec1
commit fc8c5ad776
12 changed files with 129 additions and 10 deletions
+21 -1
View File
@@ -87,7 +87,8 @@
"timePicker(props):时间选择,时 / 分两列弹层,value 信号双向绑定 HH:mm,分钟可配步长,Esc 收起",
"pinInput(props):验证码输入,N 格单字符数字输入,输入自动进格、退格回删、方向键移格、粘贴自动分发,value 信号双向绑定,mask 可密文显示",
"copyButton(props):复制按钮,点击把 text 写入剪贴板并短暂显示已复制,text 可传函数取实时值,clipboard API 不可用时降级 execCommand",
"countdown(props):倒计时,秒级递减到 0 自动停表并触发 onFinish,缺省 mm:ss 展示,返回句柄 start/stop/reset"
"countdown(props):倒计时,秒级递减到 0 自动停表并触发 onFinish,缺省 mm:ss 展示,返回句柄 start/stop/reset",
"kbd(props):键盘按键标记,键帽样式展示单个按键或组合键(多键以 + 连接),用于快捷键提示"
],
"keyTypes": [
"ButtonProps",
@@ -3846,6 +3847,25 @@
"归零自动停表并触发 onFinish;之后 start() 会重开一轮,reset() 复位到总时长",
"format 自定义展示:如只显示秒 (s) => `${s}s`,或带上小时位"
]
},
{
"id": "kbd",
"title": "键盘按键 Kbd",
"demo": "sec-kbd",
"props": [
{
"n": "keys",
"t": "string | string[]",
"r": 1,
"d": "按键内容:单键字符串或多键组合数组(组合以 + 连接展示)"
}
],
"example": "kbd({ keys: 'Esc' })、kbd({ keys: ['Ctrl', 'K'] })",
"steps": [
"传字符串展示单键帽:kbd({ keys: \"Esc\" }),适合文档里说明单个按键",
"传数组展示组合键:kbd({ keys: [\"Ctrl\", \"K\"] }),键帽之间以弱化的 + 连接(+ 对读屏隐藏)",
"常与提示文案混排:行内 baseline 对齐,键帽底边加厚一线出立体感"
]
}
]
}