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, optional description, and per-option layout hints. Supports horizontal to lay out cards in one row, showIndicator to hide radio dots, indicatorPosition, disabled, and readOnly.

RadioCardGroup

Name

Type

Default

Description

label

string

—

The label to display on the radio card

value

string

—

The value of the radio card

description

string

—

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

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
Radio vs RadioCards
Use Radio when:
Use RadioCards when:
Comparison Example
Radio Group
RadioCards Group