Radio 单选框
在一组备选项中进行单选
WARNING
label 作为 value 来使用已经被 废弃, 建议label 只用来表示展示的文字
基础用法
单选框不应该有太多的可选项, 如果你有很多的可选项你应该使用选择框而不是单选框。
要使用 Radio 组件,只需要设置v-model绑定变量, 选中意味着变量的值为相应 Radio value属性的值, value可以是String、Number 或 Boolean。
默认
禁用:设置 disabled 属性即可。
允许取消选择 1.1.14
通过allow-deselect属性设置为 true 来允许取消选择。
Options 1.1.14
基础用法 w-radio-group 的快捷示例。 您可以通过 props 属性自定义 options 的别名。
单选框组
适用于在多个互斥的选项中选择的场景
结合w-radio-group元素和子元素w-radio可以实现单选组, 为 w-radio-group 绑定 v-model,再为 每一个 w-radio 设置好 label 属性即可, 另外,还可以通过 change 事件来响应变化,它会传入一个参数 value 来表示改变之后的值。
按钮样式
你可以让单选框看起来像一个按钮一样。
只需要把 w-radio 元素换成 w-radio-button 元素即可, 此外,WinDesign Next 还提供了 size 属性用来控制单选框的大小。
带有边框
设置 border 属性为 true 可以渲染为带有边框的单选框。
Radio API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 选中项绑定值 | string / number / boolean | — |
| value | 单选框的值 | string / number / boolean | — |
| label | 单选框的 label 如果value没有值, label则作为value使用 | string / number / boolean | — |
| disabled | 是否禁用单选框 | boolean | false |
| border | 是否显示边框 | boolean | false |
| size | 单选框的尺寸 | enum | — |
| name | 原始 name 属性 | string | — |
Events
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发的事件 | Function |
Slots
| 插槽名 | 说明 |
|---|---|
| default | 自定义默认内容 |
RadioGroup API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| size | 单选框按钮或边框按钮的大小 | string | default |
| disabled | 是否禁用 | boolean | false |
| text-color | 按钮形式的 Radio 激活时的文本颜色 | string | #ffffff |
| fill | 按钮形式的 Radio 激活时的填充色和边框色 | string | #2d5afa |
| validate-event | 输入时是否触发表单的校验 | boolean | true |
| aria-label a11y | 与 RadioGroup 中的 aria-label 属性相同 | string | — |
| name | 原生 name 属性 | string | — |
| id | 原生 id 属性 | string | — |
| label a11y deprecated | 与 RadioGroup 中的 aria-label 属性相同 | string | — |
| options 1.1.14 | 选项的数据源, value 的 key 和 label 和 disabled 可以通过 props 自定义. | array | — |
| props 1.1.14 | 配置选项, 可以自定义 value, label, disabled 的 key. | object | {value: 'value', label: 'label', disabled: 'disabled'} |
| type 1.1.14 | 渲染选项的组件类型 (例如 'button') | enum | 'radio' |
| allow-deselect 1.1.14 | 是否允许取消选择 | boolean | false |
Events
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发的事件 | Function |
Slots
| 插槽名 | 说明 | 子标签 |
|---|---|---|
| default | 自定义默认内容 | Radio / RadioButton |
RadioButton API
Attributes
| 属性名 | 说明 | 类型 | 默认 |
|---|---|---|---|
| value | 单选框的值 | string / number / boolean | — |
| label | 单选框的 label 如果没有 value, label则作为value使用 | string / number / boolean | — |
| disabled | 是否禁用单选框 | boolean | false |
| name | 原生 name 属性 | string | — |
Slots
| 插槽名 | 说明 |
|---|---|
| default | 默认插槽内容 |
Copyright 2025 Winning Health 版权所有

