Radio 单选框


基本单选框

每个都是独立的单选按钮,各自需要单独绑定一个 model

Radio单选按钮 - 图1

  1. <at-radio v-model="radio" label="1">选项一</at-radio>
  2. <at-radio v-model="radio" label="2">选项二</at-radio>

不可用状态

添加属性 disabled,设置按钮不可用

Radio单选按钮 - 图2

  1. <at-radio v-model="radio2" label="3" disabled>不可点且未选中</at-radio>
  2. <at-radio v-model="radio2" label="4" disabled>不可点且选中</at-radio>

单选框组合

如果按钮存在互斥的情况,可用单选框组,但如果选项过多,建议使用下拉框组件。使用组合:AtRadioGroupAtRadio

Radio单选按钮 - 图3

  1. <at-radio-group v-model="radio3">
  2. <at-radio label="1">选项一</at-radio>
  3. <at-radio label="2">选项二</at-radio>
  4. <at-radio label="3">选项三</at-radio>
  5. </at-radio-group>

组合按钮

按钮样式的单选框组合,使用组合:AtRadioGroupAtRadioButton

Radio单选按钮 - 图4

  1. <at-radio-group v-model="radio4">
  2. <at-radio-button label="北京">北京</at-radio-button>
  3. <at-radio-button label="上海" disabled>上海</at-radio-button>
  4. <at-radio-button label="深圳">深圳</at-radio-button>
  5. <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  6. </at-radio-group>

自定义组合按钮样式

设置 fill 属性可更改选中按钮的背景颜色,设置 text-color 属性可更改选中按钮字体的颜色

Radio单选按钮 - 图5

  1. <p class="demo-desc">更换背景色</p>
  2. <div class="row">
  3. <at-radio-group v-model="radio5" fill="#FF6464">
  4. <at-radio-button label="北京">北京</at-radio-button>
  5. <at-radio-button label="上海" disabled>上海</at-radio-button>
  6. <at-radio-button label="深圳">深圳</at-radio-button>
  7. <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  8. </at-radio-group>
  9. </div>
  10. <p class="demo-desc">更换字体颜色</p>
  11. <div class="row">
  12. <at-radio-group v-model="radio5" text-color="#4C5D73">
  13. <at-radio-button label="北京">北京</at-radio-button>
  14. <at-radio-button label="上海" disabled>上海</at-radio-button>
  15. <at-radio-button label="深圳">深圳</at-radio-button>
  16. <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  17. </at-radio-group>
  18. </div>

不同大小的组合按钮

提供大中小三种尺寸的组合按钮

Radio单选按钮 - 图6

<div class="row">
  <at-radio-group v-model="radio6" size="large">
    <at-radio-button label="北京">北京</at-radio-button>
    <at-radio-button label="上海" disabled>上海</at-radio-button>
    <at-radio-button label="深圳">深圳</at-radio-button>
    <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  </at-radio-group>
</div>
<div class="row">
  <at-radio-group v-model="radio6" size="normal">
    <at-radio-button label="北京">北京</at-radio-button>
    <at-radio-button label="上海" disabled>上海</at-radio-button>
    <at-radio-button label="深圳">深圳</at-radio-button>
    <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  </at-radio-group>
</div>
<div class="row">
  <at-radio-group v-model="radio6" size="small">
    <at-radio-button label="北京">北京</at-radio-button>
    <at-radio-button label="上海" disabled>上海</at-radio-button>
    <at-radio-button label="深圳">深圳</at-radio-button>
    <at-radio-button label="凹凸实验室">凹凸实验室</at-radio-button>
  </at-radio-group>
</div>

Radio 参数

参数说明类型可选值默认值
label指定当前组件的 value 值String / Number--
value用于跟 label 比较,判断是否选中(只在单独使用时有效)String / Number--
disabled是否禁用当前项Boolean-false

Radio Button 参数

参数说明类型可选值默认值
label指定当前组件的 value 值String / Number--
disabled是否禁用当前项Boolean-false

Radio Group 参数

参数说明类型可选值默认值
size按钮尺寸,仅适用于单选按钮样式Stringsmall, normal, largenormal
value组合按钮的选中值,通常使用 v-model 绑定String / Number--
fill选中按钮的背景色String,颜色的 Hex 值--
textColor选中按钮的字体颜色String,颜色的 Hex 值--

Radio Group 事件

事件名称说明返回值
radio-group-change绑定的值变化时触发选择的按钮的 value 值