Skip to content

RadioGroup 单选框组

一组单选框的容器,允许用户在多个选项中选择一个

提示

在这里,你将了解两种 Radio 组件的使用方法

  • u-radio 适用于单个选择项的简单选择场景。
  • u-radio-group 提供分组功能,方便用户在多个选项中快速选择。

通过示例探索它们的应用效果吧!

基本用法

单选框组

Block 布局

禁用某一项

单选框禁用某项时,可使用 disabled 属性

单选框组中禁用特定选项,请使用 disabled-item 属性。

Radio 属性

属性名类型必填描述
valuenumber | string | boolean单选框的值
modelValuenumber | string | boolean绑定的值
labelstring单选框显示的文本
disabledboolean是否禁用整个单选框

Radio 事件

事件名参数类型描述
update:modelValuenumber | string | boolean单选框的值更新时触发事件

RadioGroup 属性

属性名类型必填描述
modelValuestring | number | boolean绑定值,表示当前选中的单选框值
itemsRecord<string, any>[]单选框项,数组形式,包含多个选项的数据
valueKeystring选项值的字段名称,默认为 'value'
labelKeystring标签文本的字段名称,默认为 'label'
disabledboolean是否禁用单选框组,设置为 true 时,所有选项将禁用
disabledItem(item: Record<string, any>) => boolean禁用特定选项的函数,返回 true 时禁用该选项
blockboolean是否采用块级布局,设置为 true 时,单选框项将按列显示

RadioGroup 事件

事件名参数描述
update:modelValuemodelValue: Val 选中的值值更新事件,触发时传递最新的选中值
changeitem: Record<string, any> 当前选中的选项数据选项更新事件,触发时传递当前选中的选项

基于 MIT 协议