# 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 | — | — |