跳到主要内容

Radio 单选框 ​

uni-appH5微信小程序App

跨端单选项,使用 v-model 表示当前选中状态。

何时使用 ​

与 RadioGroup 配合做互斥单选;或单独作为布尔开关项。

何时不使用 ​

多选用 Checkbox;状态开关用 Switch。

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

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

Props ​

名称类型默认值说明
modelValuebooleanfalse绑定值,配合 v-model 使用(等价 v-model:checked)
valuestring | number-在 RadioGroup 中使用的选项值
labelstring""标签文本;默认插槽存在时被覆盖
disabledbooleanfalse禁用;RadioGroup 禁用时一并禁用
checkedbooleanfalse单独使用(不在 RadioGroup 内)时的选中态,对应 v-model:checked

Events ​

名称载荷说明
update:modelValueboolean-
changeboolean单独使用时点击触发;在组内由 RadioGroup 的 change 代替
update:checkedboolean单独使用时点击触发,用于 v-model:checked;在组内不触发
clickEvent点击时触发;disabled 时不触发

示例 ​

单选组合 ​

vue
<RadioGroup v-model="picked">
  <Radio value="wx" label="微信支付" />
  <Radio value="ali" label="支付宝" />
  <Radio value="card" label="银行卡" />
</RadioGroup>

禁用项 ​

vue
<RadioGroup v-model="picked">
  <Radio value="wx" label="微信支付" />
  <Radio value="cod" label="货到付款" disabled />
</RadioGroup>

单独布尔使用 ​

vue
<Radio v-model="r4" label="订阅邮件周报" />

checked 受控 ​

vue
<view class="row">
  <Radio checked label="受控选中" />
  <Radio label="未选中" />
</view>