The living catalog

Elements01/15

Kbd

G2

The printed key. Any action used more than twice per session shows its key on the control. Renders ⌘ vs Ctrl by platform.

Posture

Inline (xs) — on controls

GCtrlEscR

Help map (sm)

↑↓EnterSpace?

npx candlelight-ds add kbd

Use when

A control has a keyboard binding.

Don't use when

Explaining a concept — that's Tooltip's job.

States
defaultbrassonBrassxssm
Acceptance
  • Never render a Kbd for a binding that doesn't fire (honest printed keys).
  • 'mod' renders ⌘ on Apple platforms, Ctrl elsewhere.

Raw twin: /components/kbd.md·Registry item: /r/kbd.json