# HTRadio 单选框

在一组备选项中进行单选

# 基础用法

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

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

# 禁用状态

单选框不可用的状态。

只要在`HTRadio`元素中设置`disabled`属性即可,它接受一个`Boolean`,`true`为禁用。

# 单选框组

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

结合`HTRadioGroup`元素和子元素`HTRadio`可以实现单选组,在`HTRadioGroup`中绑定`v-model`,在`HTRadio`中设置好`label`即可,无需再给每一个`HTRadio`绑定变量,另外,还提供了`change`事件来响应变化,它会传入一个参数`value`。

# 按钮样式

按钮样式的单选组合。

只需要把`HTRadio`元素换成`HTRadioButton`元素即可,此外,Element 还提供了`size`属性。

# 带有边框

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

# Radio Attributes

参数 说明 类型 可选值 默认值
value / v-model 绑定值 string / number / boolean
label Radio 的 value string / number / boolean
disabled 是否禁用 boolean false
border 是否显示边框 boolean false
size Radio 的尺寸,仅在 border 为真时有效 string medium / small / mini
name 原生 name 属性 string

# Radio Events

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

# Radio-group Attributes

参数 说明 类型 可选值 默认值
value / v-model 绑定值 string / number / boolean
size 单选框组尺寸,仅对按钮形式的 Radio 或带有边框的 Radio 有效 string medium / small / mini
disabled 是否禁用 boolean false
text-color 按钮形式的 Radio 激活时的文本颜色 string #ffffff
fill 按钮形式的 Radio 激活时的填充色和边框色 string #409EFF

# Radio-group Events

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

# Radio-button Attributes

参数 说明 类型 可选值 默认值
label Radio 的 value string / number
disabled 是否禁用 boolean false
name 原生 name 属性 string