mms-radio-group 单选组

简述

mms-radio-group 与 mms-radio 配合使用，在一组互斥选项中选中一项，通过 v-model 绑定当前选中项的 value（字符串）。

IMPORTANT

本组件为 mmsUnix 自研；请勿与外部未授权商业组件源码混用或逐字对照非本库文档，以免授权风险。

注意

注意： 请以 uni_modules/mms-unix 与本文为准；各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力（相册、定位、剪贴板、手机号等）需在 manifest 与后台完成配置。

平台差异说明

App（vue）	App（nvue）	H5	小程序
√	√	√	√

基本使用

<template>
	<mms-radio-group v-model="payType" name="payType" direction="row">
		<mms-radio value="wx">
			<text>微信支付</text>
		</mms-radio>
		<mms-radio value="ali">
			<text>支付宝</text>
		</mms-radio>
	</mms-radio-group>
</template>

注意：mms-radio 必须放在 mms-radio-group 内；子项 value 建议为非空字符串，并与组的 modelValue 严格相等才会显示为选中。子项 API 见 mms-radio。

Props

参数	说明	类型	默认值
modelValue	当前选中的 mms-radio 的 value	string	''
name	字段名（便于业务语义，不参与原生 form 提交）	string	''
disabled	整组禁用	boolean	false
color	子项未单独设置 color 时的默认选中填充色	string	''（子项内默认 #5677fc）
borderColor	子项未单独设置 borderColor 时的默认边框色	string	''（子项内默认 #cccccc）
direction	column 纵向 / row 横向	string	column

Events

事件名	说明	回调参数
update:modelValue	v-model 更新	选中的 value
input	与 update:modelValue 同步触发	选中的 value
change	选中项变化	选中的 value

插槽

名称	说明
default	多个 mms-radio

与表单组合

可与 mms-form、mms-input 同页使用。演示见：

• /pages_demo/form/form：资料登记中的「性别」行
• /pages_demo/radio/radio：单选能力分项示例

与 mms-segmented-control 的区别

场景	建议
分段切换、文案短、条状 UI	mms-segmented-control
表单问卷、带自定义文案/禁用项、圆形单选视觉	mms-radio-group + mms-radio