单选框
在一组互斥选项中进行单选。
警告
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 的类型可以是 String、Number 或 Boolean。
禁用状态
disabled 属性用于禁用单选框。
您只需要添加 disabled 属性即可。
单选框组
适用于在一组互斥选项中进行选择。
结合使用 el-radio-group 和 el-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 元素即可。您还可以使用 fill 和 text-color 设置按钮在激活状态下的样式。
Radio API
Radio 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| 绑定值 2.6.0 | 单选框的值 | string / number / boolean | — |
| label | 单选框的标签。如果没有设置 value,label 将作为 value 使用 | string / number / boolean | — |
| disabled | 是否禁用单选框 | boolean | false |
| 边框 | 是否为单选框添加边框 | boolean | false |
| size | 单选框的大小 | 枚举 | — |
| 名称 | 原生 name 属性 | string | — |
Radio 事件
| 名称 | 描述 | 类型 |
|---|---|---|
| change | 在绑定值改变时触发 | Function |
Radio 插槽
| 名称 | 描述 |
|---|---|
| default | 自定义默认内容 |
RadioGroup API
RadioGroup 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| size | 单选按钮或带有边框的单选框的大小 | string | default |
| disabled | 是否禁用嵌套的单选框 | boolean | false |
| validate-event | 是否触发表单验证 | boolean | true |
| 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 | 单选框的标签。如果没有设置 value,label 将作为 value 使用 | string / number / boolean | — |
| disabled | 是否禁用单选框 | boolean | false |
| 名称 | 原生 'name' 属性 | string | — |
RadioButton 插槽
| 名称 | 描述 |
|---|---|
| default | 自定义默认内容 |