RadioGroup 单选组
uni-appH5微信小程序App
跨端单选组,负责多个 Radio 的值互斥和统一 v-model。
何时使用
一组互斥选项中单选一个。
何时不使用
多选用 Checkbox;选项超过 5 个考虑下拉选择。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | number | null | null | 当前选中的 Radio 的 value,对应 v-model |
disabled | boolean | false | 整组禁用,子级 Radio 一并禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | number | null | 选中值变化时触发,用于 v-model |
change | string | number | null | 选中值变化时触发,携带新值;disabled 时不触发 |
Slots
| 名称 | 说明 |
|---|---|
default | Radio 子项 |
示例
横向排列
vue
<RadioGroup v-model="role">
<Stack direction="row" :gap="16">
<Radio value="dev" label="研发" />
<Radio value="ops" label="运维" />
<Radio value="pm" label="产品" />
</Stack>
</RadioGroup>整体禁用
vue
<RadioGroup v-model="role" disabled>
<Stack :gap="10">
<Radio value="dev" label="研发" />
<Radio value="ops" label="运维" />
</Stack>
</RadioGroup>结合 Cell 列表
vue
<RadioGroup v-model="role">
<CellGroup inset>
<Cell title="研发"><Radio value="dev" /></Cell>
<Cell title="运维"><Radio value="ops" /></Cell>
<Cell title="产品"><Radio value="pm" /></Cell>
</CellGroup>
</RadioGroup>