属性

属性	类型	默认值	说明
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 保留原生事件。

插槽

• labelIcon：标签前的装饰图标。优先于 labelIcon 属性。

模板引用

• element：HTMLDivElement | null。

原生属性

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