Radio 单选框
在一组备选项中进行单选。
警告
使用 `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>
基础用法
单选框不应有太多的可选项,否则请使用选择器组件。
创建一个单选框组件非常简单,您只需要将一个变量绑定到单选框的 `v-model` 上。它等于所选单选框 `value` 的值。`value` 的类型是 `String`、`Number` 或 `Boolean`。
禁用状态
`disabled` 属性用于禁用单选框。
您只需要添加 `disabled` 属性。
单选框组
适用于从一些互斥的选项中进行选择。
将 `el-radio-group` 与 `el-radio` 结合使用以显示一个单选框组。将一个变量与 `el-radio-group` 元素的 `v-model` 绑定,并在 `el-radio` 中设置标签值。它还提供了一个 `change` 事件,以当前值作为其参数。
按钮样式
带有按钮样式的单选框。
您只需要将 `el-radio` 元素更改为 `el-radio-button` 元素。我们还提供了 `size` 属性。
按钮样式
带有按钮样式的单选框。
您可以使用 `fill` 和 `text-color` 来设置按钮在激活状态下的样式。
带边框
`border` 属性为单选框添加边框。
Radio API
Radio 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值 | string / number / boolean | — |
value 2.6.0 | Radio 的值 | string / number / boolean | — |
label | Radio 的标签。如果没有 `value`,`label` 将作为 `value` 使用 | string / number / boolean | — |
disabled | Radio 是否被禁用 | boolean | false |
边框 | 是否在 Radio 周围添加边框 | boolean | false |
size | Radio 的尺寸 | 枚举 | — |
名称 | 原生 `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 | — |
RadioGroup 事件
名称 | 描述 | 类型 |
---|---|---|
change | 当绑定值改变时触发 | Function |
RadioGroup 插槽
名称 | 描述 | 子标签 |
---|---|---|
default | 自定义默认内容 | Radio / RadioButton |
RadioButton API
RadioButton 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
value 2.6.0 | Radio 的值 | string / number / boolean | — |
label | Radio 的标签。如果没有 `value`,`label` 将作为 `value` 使用 | string / number / boolean | — |
disabled | Radio 是否被禁用 | boolean | false |
名称 | 原生 'name' 属性 | string | — |
RadioButton 插槽
名称 | 描述 |
---|---|
default | 自定义默认内容 |