Radio 单选框
在一组备选项中进行单选。
WARNING
label 作为 value 使用的特性已被弃用,label 仅用作显示文本,请考虑切换至新的 API。
基础用法
由于选项默认可见,不宜过多,若选项过多,建议使用 Select 选择器。
要使用 Radio 组件,只需要设置 v-model 绑定变量,选中意味着变量的值为相应 Radio value 属性的值,value 可以是 String、Number 或 Boolean。
禁用状态
单选框不可用的状态。
在 u-radio 上添加 disabled 属性即可禁用。
单选框组
适用于在多个互斥的选项中选择的场景。
使用 u-radio-group 搭配 u-radio:在 u-radio-group 上绑定 v-model,在 u-radio 上设置 value。组件会触发 change 事件,参数为当前选中值。
带有边框
设置 border 可渲染为带边框的单选样式。
选项属性
基于 u-radio-group 的快捷用法:通过 options 传入数据,并用 props 自定义字段别名。
按钮样式
按钮样式的单选组合。
将 u-radio 替换为 u-radio-button;可用 size 控制尺寸,用 fill、text-color 设置激活态颜色。
单选框 API
单选框 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| value | 单选框选中时的取值 | string / number / boolean | — |
| label | 单选框展示文本;未设置 value 时,在旧版行为中 label 会充当 value | string / number / boolean | — |
| disabled | 是否禁用单选框 | boolean | false |
| border | 是否显示边框 | boolean | false |
| size | 单选框的尺寸 | enum | — |
| name | 原生 name 属性 | string | — |
单选框 事件
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发 | Function |
单选框 插槽
| 名称 | 说明 |
|---|---|
| default | 自定义默认内容 |
单选框组 API
单选框组 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string / number / boolean | — |
| size | 单选框按钮或带有边框的单选框尺寸 | string | default |
| disabled | 是否禁用嵌套单选框 | boolean | false |
| validate-event | 输入时是否触发表单的校验 | boolean | true |
| text-color | 按钮激活时的字体颜色 | string | #ffffff |
| fill | 按钮激活时的边框和背景颜色 | string | #2F54EB |
| aria-label a11y | 与 RadioGroup 原生 aria-label 属性相同 | string | — |
| name | 原生 name 属性 | string | — |
| id | 原生 id 属性 | string | — |
| options | 选项数据,value、label 和 disabled 的键名可以通过 props 自定义 | array | — |
| props | 配置选项 | object | {value: 'value', label: 'label', disabled: 'disabled'} |
| type | 用于渲染选项的组件类型 (例如 'button') | enum | 'radio' |
单选框组 事件
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 绑定值变化时触发 | Function |
单选框组 插槽
| 名称 | 说明 | 子标签 |
|---|---|---|
| default | 自定义默认内容 | 单选框 / 单选按钮 |
单选按钮 API
单选按钮 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| value | 单选按钮选中时的取值 | string / number / boolean | — |
| label | 展示文本;未设置 value 时,在旧版行为中 label 会充当 value | string / number / boolean | — |
| disabled | 是否禁用该单选按钮 | boolean | false |
| name | 原生 name 属性 | string | — |
单选按钮 插槽
| 名称 | 说明 |
|---|---|
| default | 自定义默认内容 |