Radio API

id

Unique identifier (auto-generated if not provided)

Default: useId()

label

Optional display label (passed through to slot)

value

Value associated with this radio for group selection and form submission

name

Form field name - triggers auto hidden input when provided

form

Associate with a form by ID (for radios outside the form element)

disabled

Disables this radio (prevents selection and keyboard focus)

Default: false

namespace

Namespace for context provision to children (Indicator, HiddenInput)

Default: "v0:radio:root"

groupNamespace

Namespace for connecting to parent Radio.Group

Default: "v0:radio:group"

ariaLabelledby

ID of element that labels this radio

ariaDescribedby

ID of element that describes this radio

ariaInvalid

Marks the radio as invalid for form validation

default

Default slot with radio state, actions, and ARIA attributes

namespace

Namespace for dependency injection

Default: "v0:radio:group"

disabled

Disables the entire radio group

Default: false

mandatory

Auto-selects the first non-disabled item on mount. Radio groups are inherently mandatory (selection can only be changed, not cleared), so mandatory="force" is the only meaningful option.

Default: false

label

Accessible name for the group

ariaLabelledby

ID of element that labels this group

ariaDescribedby

ID of element that describes this group

ariaRequired

Whether a selection is required before form submission

name

Form field name - enables native form submission for all radios in group

activation

Activation mode controlling when selection occurs: - automatic (default): Selection follows focus (arrow keys select) - manual: Selection requires explicit Enter/Space key press Per WAI-ARIA APG, radio groups should have selection follow focus by default. Use manual for toolbar radio groups or when deliberate selection is preferred.

Default: "automatic"

modelValue

update:model-value

default

Default slot with group state and ARIA attributes

namespace

Namespace for context injection from parent Radio.Root

Default: "v0:radio:root"

name

Form field name (defaults to context value from Radio.Group)

value

Submitted value when checked (defaults to context value or 'on'). Use to override the Radio.Root value for form submission.

form

Associate with form by ID (for inputs outside the form element)

namespace

Namespace for context injection from parent Radio.Root

Default: "v0:radio:root"

default

Default slot for custom indicator content