RadioGroup Props

Name	Type	Default	Description
v-model	string | number	—	Required. Currently selected value.
label	string	—	Required. Accessible name of the group.
id	string	—	ID of the group container. Auto-generated when omitted.
name	string	—	Shared name for the radios. Auto-generated when omitted.
options	RadioOption[]	—	Array of options. Alternative to the default slot.
width	number | string	—	Component width. Numbers are treated as px.
description	string	—	Description shown below the label.
isLabelHidden	boolean	false	Hide the visual label while keeping the accessible name.
isDisabled	boolean	false	Disable the entire group.
isReadOnly	boolean	false	Make the entire group read-only.
isRequired	boolean	false	Show required indicator and enable native required validation.
isOptional	boolean	false	Show optional indicator. Takes precedence over isRequired.
optionalLabel	string	'Optional'	Text for the optional indicator.
requiredLabel	string	'Required'	Text for the required indicator.
status	FieldStatusInput	—	Status type, message, and message ID.
statusVariant	'attached' | 'detached' | 'tooltip'	'detached'	Where to display the status message.
labelIcon	Component	—	Decorative icon before the label.
labelTooltip	string	—	Tooltip shown next to the label.

Status

status has these fields:

• type: 'error', 'warning', or 'success'.
• message: message text.
• messageId: message ID.

The default statusVariant is detached, so the message appears below the group.

Events

• update:modelValue(value): emitted after the selected value changes.
• change(value, event): fired after the model updates.

event is a cancellable RadioChangeEvent. event.detail.originalEvent keeps the native event.

Slots

• default: Radio children. Alternative to options.
• labelIcon: decorative icon before the label. Overrides the labelIcon prop.

Template ref

• element: HTMLDivElement | null.

Native attributes

class and style are applied to the outer wrapper. Unrecognized native attributes and listeners are forwarded to the group container.