Radio 单选框

在一组备选项中进行单选。

WARNING

label 作为 value 使用的特性已被弃用label 仅用作显示文本,请考虑切换至新的 API。

基础用法

由于选项默认可见,不宜过多,若选项过多,建议使用 Select 选择器。

要使用 Radio 组件,只需要设置 v-model 绑定变量,选中意味着变量的值为相应 Radio value 属性的值,value 可以是 StringNumberBoolean

禁用状态

单选框不可用的状态。

u-radio 上添加 disabled 属性即可禁用。

单选框组

适用于在多个互斥的选项中选择的场景。

使用 u-radio-group 搭配 u-radio:在 u-radio-group 上绑定 v-model,在 u-radio 上设置 value。组件会触发 change 事件,参数为当前选中值。

带有边框

设置 border 可渲染为带边框的单选样式。

选项属性

基于 u-radio-group 的快捷用法:通过 options 传入数据,并用 props 自定义字段别名。

按钮样式

按钮样式的单选组合。

u-radio 替换为 u-radio-button;可用 size 控制尺寸,用 filltext-color 设置激活态颜色。

单选框 API

单选框 属性

名称说明类型默认值
model-value / v-model绑定值string / number / boolean
value单选框选中时的取值string / number / boolean
label单选框展示文本;未设置 value 时,在旧版行为中 label 会充当 valuestring / number / boolean
disabled是否禁用单选框booleanfalse
border是否显示边框booleanfalse
size单选框的尺寸enum
name原生 name 属性string

单选框 事件

事件名说明类型
change绑定值变化时触发Function

单选框 插槽

名称说明
default自定义默认内容

单选框组 API

单选框组 属性

名称说明类型默认值
model-value / v-model绑定值string / number / boolean
size单选框按钮或带有边框的单选框尺寸stringdefault
disabled是否禁用嵌套单选框booleanfalse
validate-event输入时是否触发表单的校验booleantrue
text-color按钮激活时的字体颜色string#ffffff
fill按钮激活时的边框和背景颜色string#2F54EB
aria-label a11y与 RadioGroup 原生 aria-label 属性相同string
name原生 name 属性string
id原生 id 属性string
options选项数据,valuelabeldisabled 的键名可以通过 props 自定义array
props配置选项object{value: 'value', label: 'label', disabled: 'disabled'}
type用于渲染选项的组件类型 (例如 'button')enum'radio'

单选框组 事件

事件名说明类型
change绑定值变化时触发Function

单选框组 插槽

名称说明子标签
default自定义默认内容单选框 / 单选按钮

单选按钮 API

单选按钮 属性

名称说明类型默认值
value单选按钮选中时的取值string / number / boolean
label展示文本;未设置 value 时,在旧版行为中 label 会充当 valuestring / number / boolean
disabled是否禁用该单选按钮booleanfalse
name原生 name 属性string

单选按钮 插槽

名称说明
default自定义默认内容