Appearance
Radio 单选框
用于在备选项中选择一个,支持单独使用与配合 RadioGroup 使用;支持禁用与不同尺寸,具备无障碍(A11y)语义。
基础用法(配合 RadioGroup)
通过 RadioGroup 管理一组单选,v-model 为当前选中值。
单独使用
不依赖 RadioGroup,通过比较 modelValue 与当前 label 判断选中。
尺寸
通过 size 调整尺寸:large、default、small。
禁用
设置 disabled 后不可交互。
块状选择
设置 block 属性可以让单选框以块状形式显示。
按钮样式
设置 type="button" 可以让单选框以按钮的形式显示。
Radio Props
| 属性名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| modelValue | 绑定值(与 label 比较;单独使用时为当前值) | string | number | boolean | — | undefined |
| label | 当前单选的值(用于与 modelValue 比较) | string | number | boolean | — | undefined |
| size | 尺寸 | 'large' | 'default' | 'small' | large/default/small | default |
| disabled | 是否禁用 | boolean | — | false |
| block | 是否为块状选择样式 | boolean | — | false |
| type | 单选框类型 | 'radio' | 'button' | radio/button | radio |
Radio Events
| 事件名 | 说明 | 参数类型 |
|---|---|---|
| update:modelValue | 值变化(v-model) | string | number | boolean |
| change | 值变化(同上,便于监听) | string | number | boolean |
RadioGroup Props
| 属性名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| modelValue | 当前选中值 | string | number | boolean | — | undefined |
| size | 尺寸 | 'large' | 'default' | 'small' | large/default/small | default |
| disabled | 是否禁用 | boolean | — | false |
| block | 是否为块状选择样式 | boolean | — | false |
| type | 单选框类型 | 'radio' | 'button' | radio/button | radio |
RadioGroup Events
| 事件名 | 说明 | 参数类型 |
|---|---|---|
| update:modelValue | 当前选中值变化(v-model) | string | number | boolean |
| change | 当前选中值变化(同上) | string | number | boolean |