RadioGroup
1.0.0A set of radio buttons where only one option can be selected at a time.
Component data
- ID
- radio-group
- Category
- atoms
- Version
- 1.0.0
- Added
- 2026-09-17
- Type
- component
- Keyboard nav
- Yes
- Reduced motion
- Yes
radioradio-groupformchoiceatom
Dependencies
- @base-ui/react
- clsx
- tailwind-merge
Registry
- label
Examples
Default
<RadioGroup defaultValue={radioGroupMocks.defaultValue}>
{radioGroupMocks.options.map((option) => (
<div className="flex items-center gap-3" key={option.value}>
<RadioGroupItem id={option.value} value={option.value} />
<Label htmlFor={option.value}>{option.label}</Label>
</div>
))}
</RadioGroup>Variants
<div className="flex w-64 flex-col gap-8">
<RadioGroup defaultValue={radioGroupMocks.plans[0].value}>
{radioGroupMocks.plans.map((option) => (
<div className="flex items-center gap-3" key={option.value}>
<RadioGroupItem id={`plan-${option.value}`} value={option.value} />
<Label htmlFor={`plan-${option.value}`}>{option.label}</Label>
</div>
))}
</RadioGroup>
<RadioGroup defaultValue={radioGroupMocks.defaultValue} disabled>
{radioGroupMocks.options.map((option) => (
<div className="flex items-center gap-3" key={option.value}>
<RadioGroupItem
id={`disabled-${option.value}`}
value={option.value}
/>
<Label htmlFor={`disabled-${option.value}`}>{option.label}</Label>
</div>
))}
</RadioGroup>
<RadioGroup defaultValue={radioGroupMocks.defaultValue}>
{radioGroupMocks.options.map((option) => (
<div className="flex items-center gap-3" key={option.value}>
<RadioGroupItem
aria-invalid
id={`invalid-${option.value}`}
value={option.value}
/>
<Label htmlFor={`invalid-${option.value}`}>{option.label}</Label>
</div>
))}
</RadioGroup>
</div>
