Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Components
  2. Radio Cards
  3. API and Development

Radio cards

API and Development

View Source
Submit Issue

RadioCardGroup wraps Radix RadioCards with mutually exclusive selection. Pass options with value, label, and optional description and disabled. Layout, indicator and read-only state belong to the group: horizontal lays out cards in one row, showIndicator hides radio dots, indicatorPosition moves the dot, disabled and readOnly apply to every card. An option's own disabled disables just that card.

RadioCardGroup

Name

Type

Default

Description

label

LocalizedMessage | DisplayValue

—

The label to display on the radio card

value

string

—

The value of the radio card

description

LocalizedMessage | DisplayValue

—

Optional description text to display below the label

disabled

boolean

false

Whether the radio card is disabled

indicatorPosition

"left" | "right"

left

Position of the indicator relative to the content

isSelected

boolean

—

Whether this card is currently selected

readOnly

boolean

false

Whether the radio card is read only

showIndicator

boolean

true

Whether to show the radio indicator

Storybook

Interactive examples and edge cases for this component are in Storybook.

Default
With Description
Disabled
Disabled Option
With Right Indicator
Without Indicator
Horizontal
Horizontal With Description
Read Only
Read Only With Right Indicator
Read Only Horizontal
Variants
Indicator Variants
Radio Card Tests

Example

Basic RadioCards

Use for card-based selection with rich content.

RadioCards with Descriptions

Add descriptions to provide additional context for each option.

RadioCards with Right Indicator

Position the radio indicator on the right side.

RadioCards without Indicator

Hide radio indicators for minimal visual presentation.

Controlled RadioCards

Control RadioCards selection programmatically.

Disabled RadioCards

Disable the entire card group or specific options.

Disabling a single option

Set disabled on an option to take just that card out of the group. It can't be focused or selected, and arrow-key navigation skips it. The group's disabled still disables every card.

Radio vs RadioCards

Choose the appropriate component based on context and content needs.

Use Radio when:

  • Options are simple labels without additional context
  • Space is limited and compact presentation is needed
  • Traditional form patterns are appropriate
  • Quick selection without extensive information

Use RadioCards when:

  • Options require descriptions or additional context
  • Visual prominence and card-based presentation is desired
  • Rich content helps users make informed decisions
  • Card layout better matches the design aesthetic

Comparison Example

Radio Group

RadioCards Group

Previous

Radio Cards / Usage

Next

Radio Cards / Accessibility

On this page

RadioCardGroup
Storybook
Example
Basic RadioCards
RadioCards with Descriptions
RadioCards with Right Indicator
RadioCards without Indicator
Controlled RadioCards
Disabled RadioCards
Disabling a single option
Radio vs RadioCards
Use Radio when:
Use RadioCards when:
Comparison Example
Radio Group
RadioCards Group