Skip to content

单选按钮

属性 ​

属性类型默认值说明
valuestring | number—必需。该选项的值,选中后作为单选组的当前值。
labelstring—必需。选项的可见标签,同时作为无障碍名称供屏幕阅读器朗读。
descriptionstring—显示在标签下方的补充说明。
idstring—原生 input 元素的 ID,省略时自动生成。
isDisabledbooleanfalse是否禁用该选项,禁用后不可选择。
isReadOnlybooleanfalse是否只读。只读的选项仍可见,但无法更改选中状态。

事件 ​

  • change(value, event):用户选择该选项时触发。

当 Radio 在 RadioGroup 内使用时,事件由 RadioGroup 统一管理。

插槽 ​

  • labelIcon:标签前的装饰图标。

使用约束 ​

Radio 依赖 RadioContext 获取所在组的状态。脱离 RadioGroup 独立使用时,它会退化为无上下文状态,只能渲染一个孤零零的单选按钮。 因此建议始终把 Radio 作为 RadioGroup 或 RadioList 的子项使用。