Skip to content

Radio

A radio group built on the Radix radio primitive. Provide options as items data or as RadioItem children. Exactly one option can be selected at a time.

RadioGroup accepts the group props below; each option is a RadioItem with a value and label.

Prop Type Default Description
items RadioItemProps[] Options as data (value, label, disabled).
value string Controlled value.
defaultValue string Initial value when uncontrolled.
onValueChange (value: string) => void Called on selection.
size 'sm' | 'md' | 'lg' 'md' Control size.
error string Error message; toggles invalid styling.
disabled boolean false Disable the whole group.