项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Radio 单选框 ​

一组互斥的选项控件:在 eb-radio-group 中放置若干 eb-radio(或按钮风格的 eb-radio-button),由 group 统一管理选中值并通过 provide/inject 下发,label 即选项值,插槽内容为显示文案。在 eb-form 中 change 时机自动触发校验。

基础用法 ​

v-model 绑定选中项的 label;单个 radio 设置 disabled 只禁用自身(如上例深圳),适合个别选项不可用的场景。

整组禁用 ​

group 设置 disabled 后整组不可选,常用于权限不足或前置条件未满足时的回显展示。

边框与按钮风格 ​

border 让 Radio 呈卡片描边样式(激活态描边可用 group 的 fill 定制);eb-radio-button 为连体按钮组风格,视觉上更紧凑。

尺寸 ​

group 的 size 统一控制组内尺寸(子项单独设置会被 group 覆盖),border 与按钮风格均生效。

自定义激活色 ​

group 的 fill 定制 border 模式激活态描边色(默认主色 #175DFF);text-color 为按钮模式激活态文字色,适合按语义着色(如通过绿、驳回红)。

组合场景:通知偏好 ​

表单里常见的两级选择:通知渠道用按钮风格、推送频率用常规风格,各自独立绑定互不影响。

API ​

RadioGroup Props

参数说明类型默认值
v-model绑定值(选中项的 label),组内所有子项共享string | number | boolean
size组内尺寸,支持 large / small,子项单独设置会被覆盖string
disabled禁用整组booleanfalse
name组内原生 radio 的 name(子项可覆盖)string—
text-color激活态文字颜色string#ffffff
fill激活态填充 / 描边色(border 模式生效,默认主色)string#175DFF

Radio Props

参数说明类型默认值
v-model独立使用时的绑定值(在 group 内由 group 接管)string | number | boolean
label选项值;无插槽内容时兼作显示文案string | number | boolean
disabled禁用(与 group disabled 叠加)booleanfalse
border卡片描边样式booleanfalse
size尺寸(优先级低于 group)string
name原生 name 属性,缺省继承 group 的 namestring—

RadioButton Props

参数说明类型默认值
v-model独立使用时的绑定值string | number | boolean
label选项值;无插槽内容时兼作显示文案string | number | boolean
disabled禁用(与 group disabled 叠加)booleanfalse
size尺寸(优先级低于 group)string
name原生 name 属性,缺省继承 group 的 namestring—

Events

参数说明类型默认值
update:modelValue / change选中值变化,返回新选中项的 label(RadioGroup 与子项均触发)(value: string | number | boolean) => void—

Slots

参数说明类型默认值
defaultRadio / RadioButton 的显示文案,缺省显示 label——

Methods

参数说明类型默认值
focus使内部原生 radio 聚焦(Radio、RadioButton)() => void—
blur使内部原生 radio 失焦(Radio、RadioButton)() => void—