Radio Group
A set of mutually exclusive options where only one can be selected at a time. Built on Radix UI Radio Group.
Default
Usage
Use radio groups when users must choose exactly one option from a small set (2-5 options). For more options, use a Select.
Always show all options visually so users can compare. Each option needs a clear, concise label.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| value | string | — | Controlled selected value |
| defaultValue | string | — | Default selected value |
| onValueChange | (value: string) => void | — | Callback when selection changes |
| disabled | boolean | false | Disables the entire group |