RadioGroup

1.0.0

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

Related