Radio 单选框

Radio 单选框

在一组备选项中进行单选

基础用法

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

要使用 Radio 组件，只需要设置v-model绑定变量，选中意味着变量的值为相应 Radio label属性的值， label可以是String、Number 或 Boolean。

<template>
  <div class="mb-2 flex items-center text-sm">
    <el-radio-group v-model="radio1" class="ml-4">
      <el-radio label="1" size="large">Option 1</el-radio>
      <el-radio label="2" size="large">Option 2</el-radio>
    </el-radio-group>
  </div>
  <div class="my-2 flex items-center text-sm">
    <el-radio-group v-model="radio2" class="ml-4">
      <el-radio label="1">Option 1</el-radio>
      <el-radio label="2">Option 2</el-radio>
    </el-radio-group>
  </div>
  <div class="my-4 flex items-center text-sm">
    <el-radio-group v-model="radio3" class="ml-4">
      <el-radio label="1" size="small">Option 1</el-radio>
      <el-radio label="2" size="small">Option 2</el-radio>
    </el-radio-group>
  </div>
  <div class="mb-2 flex items-center text-sm">
    <el-radio-group v-model="radio3" disabled class="ml-4">
      <el-radio label="1" size="small">Option 1</el-radio>
      <el-radio label="2" size="small">Option 2</el-radio>
    </el-radio-group>
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const radio1 = ref('1')
const radio2 = ref('1')
const radio3 = ref('1')
</script>

禁用状态

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

你只需要为单选框设置 disabled 属性就能控制其禁用状态。

<template>
  <el-radio v-model="radio" disabled label="disabled">Option A</el-radio>
  <el-radio v-model="radio" disabled label="selected and disabled"
    >Option B</el-radio
  >
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const radio = ref('selected and disabled')
</script>

单选框组

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

结合el-radio-group元素和子元素el-radio可以实现单选组，为 el-radio-group 绑定 v-model，再为每一个 el-radio 设置好 label 属性即可，另外，还可以通过 change 事件来响应变化，它会传入一个参数 value 来表示改变之后的值。

<template>
  <el-radio-group v-model="radio">
    <el-radio :label="3">Option A</el-radio>
    <el-radio :label="6">Option B</el-radio>
    <el-radio :label="9">Option C</el-radio>
  </el-radio-group>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const radio = ref(3)
</script>

按钮样式

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

只需要把 el-radio 元素换成 el-radio-button 元素即可，此外，Element Plus 还提供了 size 属性用来控制单选框的大小。

<template>
  <div>
    <el-radio-group v-model="radio1" size="large">
      <el-radio-button label="New York" />
      <el-radio-button label="Washington" />
      <el-radio-button label="Los Angeles" />
      <el-radio-button label="Chicago" />
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio2">
      <el-radio-button label="New York" />
      <el-radio-button label="Washington" />
      <el-radio-button label="Los Angeles" />
      <el-radio-button label="Chicago" />
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio3" size="small">
      <el-radio-button label="New York" />
      <el-radio-button label="Washington" disabled />
      <el-radio-button label="Los Angeles" />
      <el-radio-button label="Chicago" />
    </el-radio-group>
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const radio1 = ref('New York')
const radio2 = ref('New York')
const radio3 = ref('New York')
</script>

带有边框

设置 border 属性为 true 可以渲染为带有边框的单选框。

<template>
  <div>
    <el-radio-group v-model="radio1">
      <el-radio label="1" size="large" border>Option A</el-radio>
      <el-radio label="2" size="large" border>Option B</el-radio>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio2">
      <el-radio label="1" border>Option A</el-radio>
      <el-radio label="2" border>Option B</el-radio>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio3" size="small">
      <el-radio label="1" border>Option A</el-radio>
      <el-radio label="2" border disabled>Option B</el-radio>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio4" size="small" disabled>
      <el-radio label="1" border>Option A</el-radio>
      <el-radio label="2" border>Option B</el-radio>
    </el-radio-group>
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const radio1 = ref('1')
const radio2 = ref('1')
const radio3 = ref('1')
const radio4 = ref('1')
</script>

Radio 属性

属性	说明	类型	可选值	默认值
model-value / v-model	选中项绑定值	string / number / boolean	—	—
label	单选框对应的值	string / number / boolean	—	—
disabled	是否禁用单选框	boolean	—	false
border	是否显示边框	boolean	—	false
size	Radio 的尺寸	string	large / default /small	—
name	原生 name 属性	string	—	—

Radio 事件

事件名	说明	回调参数
change	绑定值变化时触发的事件	选中的 Radio label 值

Radio 插槽

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

Radio-group 属性

属性	说明	类型	可选值	默认值
model-value / v-model	绑定值	string / number / boolean	—	—
size	单选框组尺寸	string	large / default / small	default
disabled	是否禁用	boolean	—	false
text-color	按钮形式的 Radio 激活时的文本颜色	string	—	#ffffff
fill	按钮形式的 Radio 激活时的填充色和边框色	string	—	#409EFF
validate-event	输入时是否触发表单的校验	boolean	-	true