Skip to content

Radio 单选框

用户要从一个数据集中选择单个选项,且能并排查看所有可选项,选项数量在 2~7 之间时,建议使用单选按钮。

基础用法

设置 v-model 绑定变量,选中意味着变量的值为相应 label 属性的值,label 可以是 String、Number 或 Boolean。

禁用状态

单选框不可用的状态。只要在 tu-radio 元素中设置 disabled 属性即可,它接受一个 Boolean,true 为禁用。

单选框组

适用于在多个互斥的选项中选择的场景。结合 tu-radio-group 元素和子元素 tu-radio 可以实现单选组,在 tu-radio-group 中绑定v-model,在 tu-radio 中设置好 label 即可,无需再给每一个 tu-radio 绑定变量,另外,还提供了 change 事件来响应变化,它会传入一个参数 value。

单选框组样式

单选框组的样式,可设置为按钮或边框样式。设置 tu-radio-group 元素属性的 type 值为 button 或 border来配置样式。

按钮样式

边框样式

单选框组尺寸

tu-radio-group 组件提供除了默认值 medium 以外的三种尺寸。额外的尺寸:large、small、mini,通过设置 size 属性来配置它们。

超小

较小

默认

较大

超小

较小

默认

较大

超小

较小

默认

较大

Radio API

Radio Attributes

参数名描述类型默认值
v-model绑定值String Number Boolean-
labelRadio 的 valueString Number Boolean-
disabled是否禁用Booleanfalse
type类型String-
size尺寸Stringmedium
name原生属性String-

Radio Events

事件名描述参数
change绑定值变化时触发的事件Function

Radio Slots

参数名描述
default自定义内容

RadioGroup API

RadioGroup Attributes

参数名描述类型默认值
v-model绑定值String Number Boolean-
type类型String-
size尺寸Stringmedium
disabled是否禁用Booleanfalse
text-color选中项标签文字颜色String-
validate-event是否进行表单校验Booleantrue
label同 RadioGroup 的 aria-labelString-
name原生属性String-
id原生属性String-

RadioGroup Events

事件名描述参数
change绑定值变化时触发的事件Function

RadioGroup Slots

参数名描述类型
default自定义内容Radio