Radio 单选框

优质
小牛编辑
120浏览
2023-12-01

在一组备选项中进行单选

基础用法

由于选项默认可见,不宜过多,若选项过多,建议使用 Select 选择器。

要使用 Radio 组件,只需要设置 [(model)]绑定变量。 如果组件中未包含内容,则会优先显示 [label] 中的内容。

<!--绑定的 model 与 label 值相同时就会被选中-->
<el-radio class="radio" [(model)]="radio" label="备选1">备选项1</el-radio>
<el-radio class="radio" [(model)]="radio" label="备选2">备选项2</el-radio>
<el-radio class="radio" [(model)]="radio" label="备选3">备选项3</el-radio>

禁用状态

单选框不可用的状态。

选中的条件是绑定的变量值等于`label`中的值。只要在el-radio元素中设置 elDisabled属性即可,它接受一个booleantrue为禁用。

<!--你可以拆分 model 达到不同的用途:-->
<!--单独使用 '[]' 来标记输入组件的值,甚至可以不声明变量-->
<!--单独使用 '(modelChange)' 来获取组件返回的变化-->
<el-radio [elDisabled]="true" [model]="'element'" label="element">备选项</el-radio>
<el-radio [elDisabled]="true" [(model)]="element2" label="element">备选项</el-radio>

单选框组

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

el-radio-group 中绑定 model, 在el-radio中设置好label即可,无需再给每一个el-radio绑定变量 (会被忽略)。

<el-radio-group [model]="'3'">
  <el-radio label="3">备选项</el-radio>
  <el-radio label="6">备选项</el-radio>
  <el-radio label="9">备选项</el-radio>
</el-radio-group>

按钮样式

按钮样式的单选组合。

只需要把 el-radio 元素换成 el-radio-button 元素即可,此组件还提供了 size 属性,支持 largesmall 两种

<el-radio-group [model]="'上海'">
  <el-radio-button label="上海">上海</el-radio-button>
  <el-radio-button label="北京">北京</el-radio-button>
  <el-radio-button label="广州">广州</el-radio-button>
  <el-radio-button label="深圳">深圳</el-radio-button>
</el-radio-group>
<div style="margin: 15px 0;"></div>
<el-radio-group [model]="'Angular'">
  <el-radio-button label="Angular">Angular</el-radio-button>
  <el-radio-button label="React">React</el-radio-button>
  <el-radio-button label="Bootstrap" [elDisabled]="true">Bootstrap</el-radio-button>
  <el-radio-button label="Vue">Vue</el-radio-button>
</el-radio-group>
<div style="margin: 15px 0;"></div>
<el-radio-group [model]="'黄山'" [elDisabled]="true">
  <el-radio-button label="华山">华山</el-radio-button>
  <el-radio-button label="武夷山">武夷山</el-radio-button>
  <el-radio-button label="长白山">长白山</el-radio-button>
  <el-radio-button label="泰山">泰山</el-radio-button>
</el-radio-group>

Radio Attributes

参数说明类型可选值默认值
labelRadio 的 valuestring,number,boolean
elDisabled是否禁用boolean
name原生 name 属性string

Radio-button Attributes

参数说明类型可选值默认值
labelRadio 的 valuestring,number
elDisabled是否禁用boolean

Radio-group Attributes

参数说明类型可选值默认值
sizeRadio 按钮组尺寸stringlarge, small
fill按钮激活时的填充色和边框色string#20a0ff
text-color按钮激活时的文本颜色string#ffffff