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
| 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. |