XDSSelectableCard@xds/core · SelectableCard

Usage

A card that toggles between selected and unselected states with an accent border. For navigation use ClickableCard.

Best practices

GuidancePractices
DoUse for plan pickers, filter chips, or option grids.
DoFor single-select track one ID; for multi-select use a Set.
Don'tUse for navigation — use ClickableCard for that.

Anatomy

ElementDescription
ContainerrequiredInteractive div with accent border on selection.
ContentrequiredChildren rendered inside the card.

Import

ts
import {XDSSelectableCard} from '@xds/core/SelectableCard'

Props

PropTypeDescription
labelrequired
stringAccessibility label.
isSelectedrequired
booleanControlled selection state.
onChangerequired
(isSelected: boolean) => voidCalled when toggled.
isDisabled
boolean (default: false)Disables the card.
children
ReactNodeCard content.
padding
SpacingStep (default: 4)Inner padding.
variant
'default' | 'transparent' | 'muted' | 'blue' | 'cyan' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow' (default: 'default')Background color variant.
width
SizeValueCard width.
height
SizeValueCard height.
maxWidth
SizeValueMaximum card width.