KQ-022 · RADIO/GROUP
Radio Group
Selection that travels, never teleports — one shared dot glides between rings while the receiving ring arms with a squash and rebounds as it lands.
KQ-022 · RADIO/GROUP
Compute tier
Tier · performance
Install
One command — the source lands in your repo. Or copy it from the Code tab.
$ pnpm dlx shadcn@latest add @kinetiq/radio-group
Props
- value / defaultValue / onValueChange
- string / string / (value) => void
- default —
- Controlled or uncontrolled selection.
- orientation
- "vertical" | "horizontal"
- default "vertical"
- Layout and aria-orientation.
- name / label
- string / ReactNode
- default —
- Hidden native radios for form posts; visible group label (or pass aria-label).
- Item.value / Item.description
- string / ReactNode
- default —
- Item identity and a muted secondary line.
| Prop | Type | Default | Description |
|---|---|---|---|
| value / defaultValue / onValueChange | string / string / (value) => void | — | Controlled or uncontrolled selection. |
| orientation | "vertical" | "horizontal" | "vertical" | Layout and aria-orientation. |
| name / label | string / ReactNode | — | Hidden native radios for form posts; visible group label (or pass aria-label). |
| Item.value / Item.description | string / ReactNode | — | Item identity and a muted secondary line. |