属性

属性	类型	默认值	说明
v-model	string | number	—	必需。当前选中的选项值。
label	string	—	必需。组的可见标签，同时作为整组的无障碍名称。
id	string	—	组容器的 ID，省略时自动生成。
name	string	—	组内所有单选按钮共享的 name，省略时自动生成。
options	RadioOption[]	—	以数组形式传入选项。与默认插槽二选一。
width	number | string	—	组件宽度，数字按 px 处理。
description	string	—	显示在组标签下方的补充说明。
isLabelHidden	boolean	false	隐藏标签的视觉呈现，但仍保留无障碍名称供屏幕阅读器朗读。
isDisabled	boolean	false	是否禁用整组，禁用后所有选项不可选择。
isReadOnly	boolean	false	是否只读。整组仍可见，但无法更改选中状态。
isRequired	boolean	false	显示必填提示，并启用原生必填校验。
isOptional	boolean	false	显示可选提示，优先于 isRequired。
optionalLabel	string	'Optional'	可选提示文本。
requiredLabel	string	'Required'	必填提示文本。
status	FieldStatusInput	—	字段状态，包含类型、消息和消息 ID。
statusVariant	'attached' | 'detached' | 'tooltip'	'detached'	状态消息的显示位置。
labelIcon	Component	—	标签前的装饰图标。
labelTooltip	string	—	标签旁信息按钮的提示文本。

状态消息

status 包含以下字段：

• type：error、warning 或 success。
• message：消息文本。
• messageId：消息 ID。

默认 statusVariant 为 detached，消息显示在组下方。

事件

• update:modelValue(value)：选中值变化后发出。
• change(value, event)：模型更新后触发。

event 是可取消的 RadioChangeEvent。 event.detail.originalEvent 保留原生事件。

插槽

• default：Radio 子项。与 options 二选一。
• labelIcon：标签前的装饰图标。优先于 labelIcon 属性。

模板引用

• element：HTMLDivElement | null。

原生属性

class 和 style 应用于组件外层。 未声明的原生属性和事件传入组容器。