Skip to content

Radio 单选框

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

基础用法

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

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

禁用状态

单选框不可用的状态。

只要在 fyo-radio 元素中设置 disabled 属性即可,它接受一个 Boolean,默认为 false

单选框组

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

结合 fyo-radio-group 元素和子元素 fyo-radio 可以实现单选框组,在 fyo-radio-group 中绑定 v-model,在 fyo-radio 中设置好 label 即可,无需再给每一个 fyo-radio 绑定变量,另外,还提供了 change 事件来响应变化,它会传入一个参数 value

按钮样式

按钮样式的单选组合。

只需要把 fyo-radio 元素换成 fyo-radio-button 元素即可,此外,fyo-radio-group 还提供了 size 属性。

带有边框

设置 border 属性可以渲染为带有边框的单选框。

API

Radio Attributes

属性名说明类型默认值
model-value / v-model绑定值string / number / boolean
labelRadio 的 valuestring / number / boolean
disabled是否禁用booleanfalse
border是否显示边框booleanfalse
sizeRadio 的尺寸(普通样式与边框样式均生效)string
name原生 name 属性string

Radio Group Attributes

属性名说明类型默认值
model-value / v-model绑定值string / number / boolean
size单选框组尺寸(按钮样式与边框样式生效,普通样式由单独 Radio 控制)string
disabled是否禁用booleanfalse
text-color按钮形式的 Radio 激活时的文本颜色string#ffffff
fill按钮形式的 Radio 激活时的填充色和边框色string#e65d6e

Radio Group Events

事件名说明回调参数
change绑定值变化时触发的事件选中的 Radio label 值