Skip to content

CheckboxGroup 复选框组

用于管理并包裹多个 <mu-checkbox> 复选框的组合容器,支持管理选中数组、横/纵排版布局与最多允许勾选的数量限制 (max)。


代码示例

1. 横向排列与数量限制

vue
<template>
  <mu-checkbox-group v-model="selected" direction="horizontal" :max="2" @change="onChange">
    <mu-checkbox name="vue" label="Vue" />
    <mu-checkbox name="react" label="React" />
    <mu-checkbox name="angular" label="Angular" />
  </mu-checkbox-group>
</template>

<script setup>
import { ref } from 'vue'

const selected = ref(['vue'])
const onChange = (val) => console.log('当前已选:', val)
</script>

API 属性说明 (Props)

参数名说明类型可选值默认值
v-model / modelValue当前包含的已勾选子项 name 集合数组Array-[]
direction子复选框排列布局方向Stringvertical | horizontal'vertical'
max最多允许勾选的选择框上限个数 (0 表示不限制)Number-0

事件说明 (Events)

事件名说明回调参数
update:modelValue双向绑定更改变(value: Array)
change选中数组改变时触发(value: Array)

插槽说明 (Slots)

插槽名说明
default子级复选框 <mu-checkbox> 容器插槽

基于 MIT 协议开源发行

H5 模拟器 (checkbox-group)☀️🔄