Skip to content

Radio 单选框

一组备选项中进行单选,支持单独使用和组合使用。

基础用法

使用 v-model 绑定值,通过 label 标识每个选项。

单选框组

使用 ZcRadioGroup 配合多个 ZcRadio 实现更简洁的用法。

禁用状态

通过 disabled 属性禁用单选项或整个选项组。

Radio API

Radio Props

参数说明类型默认值
modelValue绑定值string | number | boolean
label单选框的值(选中时作为 emit 的值)string | number | boolean
disabled是否禁用booleanfalse
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是否禁用整个组booleanfalse
name原生 name 属性,统一为所有子选项设置string

RadioGroup Events

事件名说明回调参数
update:modelValue绑定值更新时触发(value: string | number | boolean)
change选中值变化时触发(value: string | number | boolean)

基于 MIT 许可发布