# 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']
}
}
}
# 限制选择个数
使用 min 和 max 属性能够限制可以被勾选的项目的数量。
<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 内容 |