Skip to main content
The Radio and RadioGroup components let you present a set of mutually exclusive options so the user can pick exactly one. Both are Status: Draft and are backed by Mantine’s Radio primitive. Clementine exports them directly from @clementine-ds/ui with the Clementine theme applied.

When to use

  • You need to let the user select one and only one option from a small, fixed set (typically 2–6 items).
  • All options should be visible at once — no scrolling, no searching.
  • The choice requires clear visual separation between options (radio circles make mutually exclusive semantics obvious).

When not to use

  • Non-exclusive selection — use Checkbox instead so the user can pick multiple items.
  • Many options (more than ~6) — use Select to keep the interface compact.
  • A single on/off toggle — use Switch, which communicates binary state more clearly.

Usage

Import both Radio and RadioGroup from @clementine-ds/ui. Wrap individual Radio items inside a RadioGroup to wire up accessible group semantics, keyboard navigation, and shared controlled state.

Uncontrolled group

Controlled group

Disabled state


Props

Radio

RadioProps extends Mantine’s RadioProps, which itself extends the native <input type="radio"> element. All standard HTML input attributes are forwarded to the underlying input.

RadioGroup

RadioGroupProps extends Mantine’s RadioGroupProps.

Interaction states


Accessibility

  • Each Radio renders a native <input type="radio">, which provides full browser and assistive-technology support out of the box.
  • Wrapping radios in RadioGroup adds role="radiogroup" and aria-labelledby pointing at the group label.
  • Arrow keys move focus between options within the group. Tab moves focus out of the group.
  • Always provide either a label prop or an aria-label/aria-labelledby attribute on each Radio. An unlabeled input will not be announced correctly by screen readers.
  • When you use RadioGroup, set the label prop on the group — it becomes the accessible name for the entire radiogroup region.

Draft status. The Radio and RadioGroup components are currently Draft. Verify that role="radiogroup" is correctly emitted on the RadioGroup wrapper and that arrow-key navigation between options works as expected in your target browsers before shipping to production.