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.0Radio 的值string / number / boolean
labelRadio 的标签。如果没有 `value`,`label` 将作为 `value` 使用string / number / boolean
disabledRadio 是否被禁用booleanfalse
边框是否在 Radio 周围添加边框booleanfalse
sizeRadio 的尺寸枚举
名称原生 `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

RadioGroup 事件

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

RadioGroup 插槽

名称描述子标签
default自定义默认内容Radio / RadioButton

RadioButton API

RadioButton 属性

名称描述类型默认值
value 2.6.0Radio 的值string / number / boolean
labelRadio 的标签。如果没有 `value`,`label` 将作为 `value` 使用string / number / boolean
disabledRadio 是否被禁用booleanfalse
名称原生 'name' 属性string

RadioButton 插槽

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

来源

组件样式文档

贡献者