Radio Group

Installation#

pnpm add @ag/ui

Usage#

import { Label } from "@ag/ui"
import { RadioGroup, RadioGroupItem } from "@ag/ui"

<RadioGroup defaultValue="option-one">
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-one" id="option-one" />
    <Label htmlFor="option-one">Option One</Label>
  </div>
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-two" id="option-two" />
    <Label htmlFor="option-two">Option Two</Label>
  </div>
</RadioGroup>

Composition#

Use the following composition to build a RadioGroup:

RadioGroup
├── RadioGroupItem
└── RadioGroupItem

Examples#

Description#

Radio group items with a description using the Field component.

Choice Card#

Use FieldLabel to wrap the entire Field for a clickable card-style selection.

Fieldset#

Use FieldSet and FieldLegend to group radio items with a label and description.

Disabled#

Use the disabled prop on RadioGroupItem to disable individual items.

Invalid#

Use aria-invalid on RadioGroupItem and data-invalid on Field to show validation errors.

RTL#

To enable RTL support in shadcn/ui, see the RTL configuration guide.

API Reference#

See the Radix UI Radio Group documentation.