Radio 单选框
uni-appH5微信小程序App
跨端单选项,使用 v-model 表示当前选中状态。
何时使用
与 RadioGroup 配合做互斥单选;或单独作为布尔开关项。
何时不使用
多选用 Checkbox;状态开关用 Switch。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 绑定值,配合 v-model 使用(等价 v-model:checked) |
value | string | number | - | 在 RadioGroup 中使用的选项值 |
label | string | "" | 标签文本;默认插槽存在时被覆盖 |
disabled | boolean | false | 禁用;RadioGroup 禁用时一并禁用 |
checked | boolean | false | 单独使用(不在 RadioGroup 内)时的选中态,对应 v-model:checked |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | - |
change | boolean | 单独使用时点击触发;在组内由 RadioGroup 的 change 代替 |
update:checked | boolean | 单独使用时点击触发,用于 v-model:checked;在组内不触发 |
click | Event | 点击时触发;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>