跳到主要内容

RadioGroup 单选组 ​

uni-appH5微信小程序App

跨端单选组,负责多个 Radio 的值互斥和统一 v-model。

何时使用 ​

一组互斥选项中单选一个。

何时不使用 ​

多选用 Checkbox;选项超过 5 个考虑下拉选择。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
RadioGroup 单选组 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring | number | nullnull当前选中的 Radio 的 value,对应 v-model
disabledbooleanfalse整组禁用,子级 Radio 一并禁用

Events ​

名称载荷说明
update:modelValuestring | number | null选中值变化时触发,用于 v-model
changestring | number | null选中值变化时触发,携带新值;disabled 时不触发

Slots ​

名称说明
defaultRadio 子项

示例 ​

横向排列 ​

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>