mms-checkbox-group 多选组

简述

mms-checkbox-group 与 mms-checkbox 配合使用，可在同一组内多选；v-model 绑定值为字符串数组（各选中项的 value）。

IMPORTANT

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

注意

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

平台差异说明

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

基本使用

<template>
	<mms-checkbox-group v-model="hobbies" name="hobbies" direction="row">
		<mms-checkbox value="read">
			<text>阅读</text>
		</mms-checkbox>
		<mms-checkbox value="sport">
			<text>运动</text>
		</mms-checkbox>
	</mms-checkbox-group>
</template>

注意：组内使用时 mms-checkbox 必须放在 mms-checkbox-group 内；每项 value 建议为非空字符串，且在组内唯一，便于与 modelValue 比较。子项与独立用法见 mms-checkbox。

Props

参数	说明	类型	默认值
modelValue	当前选中的 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 更新	string[]
input	与 update:modelValue 同步触发	string[]
change	选中集合变化	string[]

插槽

名称	说明
default	多个 mms-checkbox

与表单组合

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

• /pages_demo/form/form：资料登记中的「爱好」多选
• /pages_demo/checkbox/checkbox：多选能力分项示例

与 mms-radio-group 的区别

场景	建议
互斥单选	mms-radio-group + mms-radio，v-model 为单个 string
多选、零项或多项	mms-checkbox-group + mms-checkbox，v-model 为 string[]