m-checkbox-group 多选组

简述

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

IMPORTANT

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

注意

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

平台差异说明

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

演示地址

与线上 H5 演示基座分包一致（文档站右下角预览 iframe 亦指向同一路径）。

类型	地址
分包路径	`pages_demo/checkbox/checkbox`
线上 H5（hash）	打开演示

基本使用

uvue

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

注意：组内使用时 m-checkbox 必须放在 m-checkbox-group 内；每项 value 建议为非空字符串，且在组内唯一，便于与 modelValue 比较。子项与独立用法见 m-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`	多个 `m-checkbox`

与表单组合

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

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

与 m-radio-group 的区别

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

m-checkbox-group 多选组 ​

简述 ​

平台差异说明 ​

演示地址 ​

基本使用 ​

Props ​

Events ​

插槽 ​

与表单组合 ​

与 m-radio-group 的区别 ​