Skip to content

Radio

Radio Props ​

NameTypeDefaultDescription
valuestring | number—Required. Option value.
labelstring—Required. Visible label and accessible name.
descriptionstring—Description shown below the label.
idstring—ID of the native input. Auto-generated when omitted.
isDisabledbooleanfalseDisable this option.
isReadOnlybooleanfalseMake this option read-only.

Events ​

  • change(value, event): fired when the user selects this option.

When Radio is used inside RadioGroup, RadioGroup coordinates the change events.

Slots ​

  • labelIcon: decorative icon before the label.

Usage constraint ​

Radio depends on RadioContext. When used standalone, it falls back to a context-free state and renders a single radio button only. Always use Radio as a child of RadioGroup or RadioList.