Kbd 键盘输入

标记用户需要按下的单键、组合键或连续按键。

Beta

示例

直接操作示例,查看组件在具体任务中的状态与反馈。

Kbd 只标记用户需要按下的键,不会注册或执行键盘快捷操作。
同时按键

打开搜索:Ctrl + K

保存草稿:Ctrl + S

连续按键

前往组件目录:依次按 G,再按 C

加号表示同时按下,箭头表示依次按下。
键盘说明

同时按下:Ctrl + Shift + P

依次按下:GD

使用建议

只标记真实键盘输入

Kbd 用于说明用户需要按下的键,不用于装饰普通标签、筛选项或按钮文案。

区分组合与连续操作

同时按键使用加号连接,连续按键使用“再按”或逗号说明,避免只靠视觉间距猜测。

跟随平台显示名称

如果产品跨平台,宿主应根据当前平台显示 Ctrl、Command、Alt 或 Option 等用户熟悉的名称。

引入方式

从已验证的公开子路径导入组件;全局样式接入方式见安装指南。

import { BaseKbd } from '@inf-monkeys-tech/monkeys-design/components/base';

当前限制

  • Kbd 只呈现键帽语义,不注册快捷键、处理冲突或自动切换平台符号;实际键盘行为必须由宿主实现并测试。
  • Automated axe checks and deterministic browser visual evidence are pending T17/T23.
export interface BaseKbdProps
  extends Omit<
    HTMLAttributes<HTMLElement>,
    'children' | 'className' | 'style'
  > {
  children?: ReactNode;
  appearance?: BaseAppearance;
  className?: string;
  classNames?: BaseKbdClassNames;
  style?: CSSProperties;
}
属性说明类型默认值
children在 BaseKbd 内渲染的子内容;支持渲染函数时以对应的 Props 类型为准。ReactNode
appearance覆盖组件使用的外观令牌或局部样式配置。BaseAppearance
className追加到组件根元素的 CSS 类名。string
classNames按组件公开的结构插槽分别追加 CSS 类名。BaseKbdClassNames
style追加到组件根元素的内联样式。CSSProperties