Appearance
Radio 单选框
在一组备选项中进行单选。
基础用法
由于选项默认可见,不宜过多,若选项过多,建议使用 Select 选择器。
要使用 Radio 组件,只需要设置 v-model 绑定变量,选中意味着变量的值为相应 Radio label 属性的值,label 可以是 String、Number 或 Boolean。
禁用状态
单选框不可用的状态。
只要在 fyo-radio 元素中设置 disabled 属性即可,它接受一个 Boolean,默认为 false。
单选框组
适用于在多个互斥的选项中选择的场景。
结合 fyo-radio-group 元素和子元素 fyo-radio 可以实现单选框组,在 fyo-radio-group 中绑定 v-model,在 fyo-radio 中设置好 label 即可,无需再给每一个 fyo-radio 绑定变量,另外,还提供了 change 事件来响应变化,它会传入一个参数 value。
按钮样式
按钮样式的单选组合。
只需要把 fyo-radio 元素换成 fyo-radio-button 元素即可,此外,fyo-radio-group 还提供了 size 属性。
带有边框
设置 border 属性可以渲染为带有边框的单选框。
API
Radio Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| label | Radio 的 value | string / number / boolean | — |
| disabled | 是否禁用 | boolean | false |
| border | 是否显示边框 | boolean | false |
| size | Radio 的尺寸(普通样式与边框样式均生效) | string | — |
| name | 原生 name 属性 | string | — |
Radio Group Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| size | 单选框组尺寸(按钮样式与边框样式生效,普通样式由单独 Radio 控制) | string | — |
| disabled | 是否禁用 | boolean | false |
| text-color | 按钮形式的 Radio 激活时的文本颜色 | string | #ffffff |
| fill | 按钮形式的 Radio 激活时的填充色和边框色 | string | #e65d6e |
Radio Group Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 绑定值变化时触发的事件 | 选中的 Radio label 值 |