Radio 单选框

WARNING

label 作为 value 来使用已经被 废弃, 建议label 只用来表示展示的文字,这个被废弃的用法将会在 3.0.0 版本被移除,请考虑使用新 API 替换.

新 API value2.6.0 中已经可用,您可以使用 value API 来设置复选框的值。

在一组备选项中进行单选

基础用法

单选框不应该有太多的可选项, 如果你有很多的可选项你应该使用选择框而不是单选框。

禁用状态

disabled 属性可以用来控制单选框的禁用状态。

单选框组

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

按钮样式

你可以让单选框看起来像一个按钮一样。

带有边框

Radio API

Radio Attributes

属性名说明类型默认值
model-value / v-model选中项绑定值string / number / boolean
value 2.6.0单选框的值string / number / boolean
label单选框的 label 如果value没有值, label则作为value使用string / number / boolean
disabled是否禁用单选框booleanfalse
border是否显示边框booleanfalse
size单选框的尺寸enum
name原始 name 属性string

Radio Events

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

Radio Slots

插槽名说明
default自定义默认内容

RadioGroup API

RadioGroup Attributes

属性名说明类型默认值
model-value / v-model绑定值string / number / boolean
size单选框按钮或边框按钮的大小stringdefault
disabled是否禁用booleanfalse
text-color按钮形式的 Radio 激活时的文本颜色string#ffffff
fill按钮形式的 Radio 激活时的填充色和边框色string#409eff
validate-event输入时是否触发表单的校验booleantrue
label a11y与 RadioGroup 中的 aria-label 属性相同string
name原生 name 属性string
id原生 id 属性string

RadioGroup Events

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

RadioGroup Slots

插槽名说明子标签
default自定义默认内容Radio / RadioButton

RadioButton API

RadioButton Attributes

属性名说明类型默认
value 2.6.0单选框的值string / number / boolean
label单选框的 label 如果没有 value, label则作为value使用string / number / boolean
disabled是否禁用单选框booleanfalse
name原生 name 属性string

RadioButton Slots

插槽名说明
default默认插槽内容

源代码

组件文档

贡献者