Radio Group

Basic

A set of round buttons where you can select only one option from the group.

Installation

Install the component via the CLI in one command.

npx shadcn@latest add @intentui/radio

Composed components

Manual installation

Use this approach if you prefer to install and wire up the component yourself instead of using the CLI.

npm install react-aria-components

Anatomy

import { Description, Label } from "@/components/ui/field"
import { Radio, RadioGroup } from "@/components/ui/radio"

<RadioGroup name="billing">
  <Label>Billing Cycle</Label>
  <Description>
    Select how often you'd like to be billed
  </Description>

  <Radio value="monthly">
    <Label>Monthly</Label>
    <Description>Billed every month</Description>
  </Radio>
  <Radio value="quarterly">
    <Label>Quarterly</Label>
    <Description>Billed every 3 months</Description>
  </Radio>
  <Radio value="yearly">
    <Label>Yearly</Label>
    <Description>
      Billed once per year with a discount
    </Description>
  </Radio>
</RadioGroup>

Orientation

By default, the radio group is vertically oriented. You can change it to a horizontal orientation by using the orientation prop.

Without label

The label is optional. You can omit it if not needed.

Description

Add a description to the radio group by passing the description prop.

Validation

Try submit the form without selecting any radio option to see the validation error.

Controlled

You can control the radio group value using the value prop.

Uncontrolled

You can control the radio group value using the defaultValue prop.

Disabled

When the radio group is disabled, it cannot be interacted with.