On this page:

Radio

Preview

index.tsx

Group radio

Preview

index.tsx

Controlled Group radio

Preview

index.tsx

Group value: radio-2

Generate Group radio with array

Preview

index.tsx

Design Tokens for Radio

TokenColor forState/Meaning
--par-color-icon-radio-enabledRadio iconEnabled
--par-color-icon-radio-disabledRadio iconDisabled
--par-color-icon-radio-neutral-selectedRadio iconChecked (neutral)
--par-color-icon-radio-neutral-disabledRadio iconDisabled (neutral)
--par-color-icon-radio-accent-selectedRadio iconChecked (accent)
--par-color-icon-radio-accent-disabledRadio iconDisabled (accent)

Radio API Reference

<Radio />

PropTypeDefaultDescription
checkedbooleanChecked state (controlled)
onChangefunction (event)Callback when radio value changes
valuestring | numberValue of the radio
labelstring | ReactNodeLabel for the radio
sublabelstring | ReactNodeSublabel for the radio
disabledbooleanfalseDisable the radio
color'neutral' | 'accent''neutral'Radio color theme
radioWrapperPropsanyProps for the radio wrapper
...InputPropsSee InputInherits all props from Input and native input[type=radio]

Note: Radio inherits all props from Input and the native input[type=radio] element. See Input documentation for full details on available props and tokens.

RadioGroup API Reference

<RadioGroup />

PropTypeDefaultDescription
namestringName for all radios in the group (required)
labelstring | ReactNodeLabel for the radio group
defaultValuestring | numberDefault value (uncontrolled)
valuestring | numberValue of the selected radio (controlled)
disabledbooleanfalseDisable all radios in the group
color'neutral' | 'accent''neutral'Color theme for all radios
itemsRadioProps[]Array of radio item props to auto-generate radios
onChangefunction (value: string | number)Callback when selected value changes
childrenReactNodeCustom radio elements as children

Note: RadioGroup can generate radios from the items array or accept custom <Radio /> children. It controls the name, checked, and onChange props for its radios.