Radio 单选框
一组备选项中进行单选,支持单独使用和组合使用。
基础用法
使用 v-model 绑定值,通过 label 标识每个选项。
单选框组
使用 ZcRadioGroup 配合多个 ZcRadio 实现更简洁的用法。
禁用状态
通过 disabled 属性禁用单选项或整个选项组。
Radio API
Radio Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
modelValue | 绑定值 | string | number | boolean | — |
label | 单选框的值(选中时作为 emit 的值) | string | number | boolean | — |
disabled | 是否禁用 | boolean | false |
name | 原生 name 属性 | string | — |
Radio Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
update:modelValue | 绑定值更新时触发 | (value: string | number | boolean) |
change | 选中值变化时触发 | (value: string | number | boolean) |
Radio Slots
| 插槽名 | 说明 |
|---|---|
default | 单选框标签内容(默认显示 label 文本) |
RadioGroup Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
modelValue | 绑定的选中值 | string | number | boolean | — |
disabled | 是否禁用整个组 | boolean | false |
name | 原生 name 属性,统一为所有子选项设置 | string | — |
RadioGroup Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
update:modelValue | 绑定值更新时触发 | (value: string | number | boolean) |
change | 选中值变化时触发 | (value: string | number | boolean) |