单选框

在一组互斥选项中进行单选。

警告

label 作为 value 的用法已**废弃**,label 仅用于显示文本,此行为**将**在 3.0.0 中移除,请考虑切换到新 API。

提示

新 API value 已在 2.6.0 版本中添加,文档中的示例均已使用 value。如果您使用的版本**低于** 2.6.0,请参考

vue
<template>
  <el-radio-group v-model="radio1">
    <!-- works when >=2.6.0, recommended ✔️ not work when <2.6.0 ❌ -->
    <el-radio value="Value 1">Option 1</el-radio>
    <!-- works when <2.6.0, deprecated act as value when >=3.0.0 -->
    <el-radio label="Label 2 & Value 2">Option 2</el-radio>
  </el-radio-group>
</template>

基础用法

单选框不应包含过多选项。否则,请使用 Select 组件替代。

创建一个单选框组件非常容易,您只需将一个变量绑定到 Radio 的 v-model 即可。它等于所选单选框的 value 值。value 的类型可以是 StringNumberBoolean

禁用状态

disabled 属性用于禁用单选框。

您只需要添加 disabled 属性即可。

单选框组

适用于在一组互斥选项中进行选择。

结合使用 el-radio-groupel-radio 即可显示单选框组。在 el-radio-group 元素上绑定 v-model 变量,并在 el-radio 中设置 label 值。它还提供 change 事件,其参数为当前值。

带有边框

border 属性为单选框添加边框。

Options 属性 2.11.2

基本 el-radio-group 用法的简写。您可以通过 props 属性自定义 options 的别名。

单选按钮

具有按钮组视觉效果的单选框。

您只需将 el-radio 元素更改为 el-radio-button 元素即可。您还可以使用 filltext-color 设置按钮在激活状态下的样式。

Radio API

Radio 属性

名称描述类型默认值
model-value / v-model绑定值string / number / boolean
绑定值 2.6.0单选框的值string / number / boolean
label单选框的标签。如果没有设置 valuelabel 将作为 value 使用string / number / boolean
disabled是否禁用单选框booleanfalse
边框是否为单选框添加边框booleanfalse
size单选框的大小枚举
名称原生 name 属性string

Radio 事件

名称描述类型
change在绑定值改变时触发Function

Radio 插槽

名称描述
default自定义默认内容

RadioGroup API

RadioGroup 属性

名称描述类型默认值
model-value / v-model绑定值string / number / boolean
size单选按钮或带有边框的单选框的大小stringdefault
disabled是否禁用嵌套的单选框booleanfalse
validate-event是否触发表单验证booleantrue
text-color按钮激活时的字体颜色string#ffffff
填充色按钮激活时的边框和背景颜色string#409eff
aria-label a11y 2.7.2与 RadioGroup 中的 aria-label 相同string
名称原生 name 属性string
id原生 id 属性string
label a11y 已废弃与 RadioGroup 中的 aria-label 相同string
选项 2.11.2选项数据,其中 `value` 和 `label` 和 `disabled` 的键名可以通过 `props` 自定义array
配置项 2.11.2配置选项object{value: 'value', label: 'label', disabled: 'disabled'}
类型 2.11.5用于渲染选项的组件类型(例如 'button'枚举'radio'

RadioGroup 事件

名称描述类型
change在绑定值改变时触发Function

RadioGroup 插槽

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

RadioButton API

RadioButton 属性

名称描述类型默认值
绑定值 2.6.0单选框的值string / number / boolean
label单选框的标签。如果没有设置 valuelabel 将作为 value 使用string / number / boolean
disabled是否禁用单选框booleanfalse
名称原生 'name' 属性string

RadioButton 插槽

名称描述
default自定义默认内容

来源

组件样式文档

贡献者