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 | 子复选框排列布局方向 | String | vertical | horizontal | 'vertical' |
| max | 最多允许勾选的选择框上限个数 (0 表示不限制) | Number | - | 0 |
事件说明 (Events)
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| update:modelValue | 双向绑定更改变 | (value: Array) |
| change | 选中数组改变时触发 | (value: Array) |
插槽说明 (Slots)
| 插槽名 | 说明 |
|---|---|
| default | 子级复选框 <mu-checkbox> 容器插槽 |