# CheckBox 多选框

# 介绍

一组备选项中进行多选。

# 引入

import { CheckboxGroup, Checkbox } from 'mind-ui-vue';
Vue.use(CheckboxGroup);
Vue.use(Checkbox);

# 示例

# 基础用法

<m-checkbox v-model="checkbox" @change="onChange">复选框</m-checkbox>

# 圆形

<m-checkbox v-model="checkbox" round>复选框</m-checkbox>

# 自定义颜色

<m-checkbox v-model="checkbox" checked-color="red">复选框</m-checkbox>

# 禁用状态

<m-checkbox v-model="checkbox" disabled>复选框</m-checkbox>

# label 居左

<m-checkbox label-left v-model="checkbox">复选框</m-checkbox>

# 多选框组

<m-checkbox-group v-model="checkList">
  <m-checkbox name="a">复选框a</m-checkbox>
  <m-checkbox name="b">复选框b</m-checkbox>
  <m-checkbox name="c">复选框c</m-checkbox>
  <m-checkbox name="d">复选框d</m-checkbox>
</m-checkbox-group>
export default {
  data () {
    return {
      checkList: ['a','b']
    }
  }
}

# 限制选择个数

使用 minmax 属性能够限制可以被勾选的项目的数量。

<m-checkbox-group v-model="checkList" :min="1" :max="2">
  <m-checkbox name="a">复选框a</m-checkbox>
  <m-checkbox name="b">复选框b</m-checkbox>
  <m-checkbox name="c">复选框c</m-checkbox>
  <m-checkbox name="d">复选框d</m-checkbox>
</m-checkbox-group>
export default {
  data () {
    return {
      checkList: ['a','b']
    }
  }
}

# Api

# CheckboxGroup Props

参数 说明 类型 可选值 默认值
v-model 选中项 name 集合 Array []
name 在表单内提交时的标识符 String
min 最少选中数量 Number 0
max 最多选中数量 Number -
disabled 是否禁用 Boolean false
label-left 文字在左边 Boolean false
checked-color 选中状态颜色 String
round 是否圆形 Boolean false

# CheckboxGroup Events

方法名称 说明
change 选中值变更时触发回调 event.detail 当前选中项 name

# Checkbox Props

参数 说明 类型 可选值 默认值
v-model 是否选中 Boolean false
name 在表单内提交时的标识符 String
disabled 是否禁用 Boolean false
label-left 文字在左边 Boolean false
checked-color 选中状态颜色,优先级高于 group String
round 是否圆形 Boolean false

# Checkbox Events

方法名称 说明
change 选中值变更时触发回调 event.detail 当前 checked 状态值

# Checkbox Slots

名称 说明
label 内容