m-checkbox 多选项

简述

m-checkbox 表示一个可勾选选项：在 m-checkbox-group 内可多选并绑定 string[]；也可脱离组单独使用，用 checked 表示布尔状态（如协议勾选）。

IMPORTANT

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

注意

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

平台差异说明

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

演示地址

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

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

基本使用

完整写法与组级 v-model 见 m-checkbox-group。典型结构：

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

注意：组内使用时须放在 m-checkbox-group 内；每项 value 在组内唯一。

Props

参数	说明	类型	默认值
value	选项值；组内选中时写入 modelValue；独立使用时参与 change 回调	string	''
disabled	单项禁用（组 disabled 为 true 时全部禁用）	boolean	false
checked	仅独立使用：是否选中；建议 :checked + @update:checked 双向绑定（各端兼容）	boolean	false
color	选中填充色；checkOnly 时为对号颜色	string	''（继承组或 #5677fc）
borderColor	未选中时的描边颜色	string	''（继承组或 #cccccc）
checkMarkColor	填充框内对号颜色	string	#ffffff
size	方框（或对号区）边长，rpx	number | string	40
scale	图标区域整体缩放倍数	number | string	1
checkOnly	为 true 时选中仅显示对号，无填充底	boolean	false

Events

事件名	说明	回调参数
update:checked	独立使用时切换选中	boolean
change	独立使用时选中状态变化	{ checked: boolean, value: string }
click	点击且状态已切换（组内为切换后的该项 value）	string

插槽

名称	说明
default	选项文案（如图标 + 文字）

独立使用（无 group）

适用于协议勾选等单布尔场景：

<m-checkbox :checked="agree" value="1" @update:checked="agree = $event">
	<text>我已阅读并同意</text>
</m-checkbox>

在部分小程序端自定义组件对 v-model:checked 支持不完整，推荐显式 :checked + @update:checked。也可监听 @change 自行维护状态。

与表单组合

可与 m-form、m-input、m-radio-group 同页使用；组内演示路径见 m-checkbox-group。