Radio 单选框

在一组备选项中进行单选

WARNING

label 作为 value 来使用已经被 废弃, 建议label 只用来表示展示的文字

基础用法

单选框不应该有太多的可选项, 如果你有很多的可选项你应该使用选择框而不是单选框。

要使用 Radio 组件,只需要设置v-model绑定变量, 选中意味着变量的值为相应 Radio value属性的值, value可以是StringNumberBoolean

默认
禁用:设置 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是否禁用单选框booleanfalse
border是否显示边框booleanfalse
size单选框的尺寸enum
name原始 name 属性string

Events

事件名说明类型
change绑定值变化时触发的事件Function

Slots

插槽名说明
default自定义默认内容

RadioGroup API

Attributes

属性名说明类型默认值
model-value / v-model绑定值string / number / boolean
size单选框按钮或边框按钮的大小stringdefault
disabled是否禁用booleanfalse
text-color按钮形式的 Radio 激活时的文本颜色string#ffffff
fill按钮形式的 Radio 激活时的填充色和边框色string#2d5afa
validate-event输入时是否触发表单的校验booleantrue
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是否允许取消选择booleanfalse

Events

事件名说明类型
change绑定值变化时触发的事件Function

Slots

插槽名说明子标签
default自定义默认内容Radio / RadioButton

RadioButton API

Attributes

属性名说明类型默认
value单选框的值string / number / boolean
label单选框的 label 如果没有 value, label则作为value使用string / number / boolean
disabled是否禁用单选框booleanfalse
name原生 name 属性string

Slots

插槽名说明
default默认插槽内容

Copyright 2025 Winning Health 版权所有