id: kbd
label: Kbd
family: family-c-forms
category: Display
intent: Display keyboard shortcut
description: Keyboard shortcut display
composable: false
capabilities:
required_parts: []
optional_parts: []
tags: ["kbd", "keyboard", "shortcut", "ctrl", "cmd"]
keywords:
pain: Keyboard shortcuts displayed inconsistently with ad-hoc styling
promise: Shortcut representation standardized via size and variant enums
why: |
KbdPrimitive encodes size and variant into data attributes. Group and separator primitives enforce consistent composition. This guarantees uniform shortcut display.
rules: ["CR-001", "CR-004"]
use_cases: ["shortcuts", "docs"]
related: ["avatar", "icon", "logo", "code_block", "markdown", "chart", "stat", "inline_meta", "badge", "carousel"]
file: kbd_ui.css
tokens: kbd-*, space-*, radius-*, font-*, shadow-*
foundation: spacing, radius, shadow, typography
states: []
island: kbd_boundary.rs
pillar: content_display
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift"]
before: |
// ❌ Typical
view! {
<span class="kbd">Ctrl + K</span>
}
after: |
// ✅ CanonRS
view! {
<KbdGroup>
<Kbd>"Ctrl"</Kbd>
<KbdSeparator />
<Kbd>"K"</Kbd>
</KbdGroup>
}
boundary_type: passthrough
block: []
blocks_primitives: [flex, stack]