mirror of https://github.com/ElemeFE/element
126 lines
3.3 KiB
Markdown
126 lines
3.3 KiB
Markdown
<script>
|
|
module.exports = {
|
|
data() {
|
|
return {
|
|
checkList: ['选中且禁用','复选框 A'],
|
|
// checkList2: ['复选框 A'],
|
|
checked: false,
|
|
checked1: false,
|
|
checked2: true,
|
|
isValid: '可用'
|
|
};
|
|
},
|
|
methods: {
|
|
handleChange(ev) {
|
|
console.log(ev);
|
|
}
|
|
}
|
|
};
|
|
</script>
|
|
|
|
<style>
|
|
.demo-box.demo-checkbox {
|
|
.checkbox {
|
|
margin-right: 5px;
|
|
|
|
& + .checkbox {
|
|
margin-left: 10px;
|
|
}
|
|
}
|
|
}
|
|
</style>
|
|
## Checkbox 多选框
|
|
一组备选项中进行多选
|
|
|
|
### 基础用法
|
|
|
|
单独使用可以表示两种状态之间的切换
|
|
|
|
:::demo 在`el-checkbox`元素中定义`v-model`绑定变量，单一的`checkbox`中，默认绑定变量的值会是`Boolean`，选中为`true`。
|
|
|
|
```html
|
|
<template>
|
|
<!-- `checked` 为 true 或 false -->
|
|
<el-checkbox v-model="checked" checked>备选项</el-checkbox>
|
|
</template>
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
checked: true
|
|
};
|
|
}
|
|
};
|
|
</script>
|
|
```
|
|
:::
|
|
|
|
## 禁用状态
|
|
|
|
多选框不可用状态。
|
|
|
|
::: demo 设置`disabled`属性即可。
|
|
|
|
```html
|
|
<template>
|
|
<el-checkbox v-model="checked1" disabled>备选项1</el-checkbox>
|
|
<el-checkbox v-model="checked2" disabled>备选项</el-checkbox>
|
|
</template>
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
checked1: false,
|
|
checked2: true
|
|
};
|
|
}
|
|
};
|
|
</script>
|
|
```
|
|
:::
|
|
|
|
### 多选框组
|
|
|
|
适用于多个勾选框绑定到同一个数组的情景，通过是否勾选来表示这一组选项中选中的项。
|
|
|
|
:::demo `checkbox-group`元素能把多个 checkbox 管理为一组，只需要在 Group 中使用`v-model`绑定`Array`类型的变量即可，`label`属性除了改变 checkbox 按钮后的介绍外，同时也是该 checkbox 对应的值，`label`与数组中的元素值相对应，如果存在指定的值则为选中状态，否则为不选中。
|
|
|
|
```html
|
|
<template>
|
|
<el-checkbox-group v-model="checkList">
|
|
<el-checkbox label="复选框 A"></el-checkbox>
|
|
<el-checkbox label="复选框 B"></el-checkbox>
|
|
<el-checkbox label="复选框 C"></el-checkbox>
|
|
<el-checkbox label="禁用" disabled></el-checkbox>
|
|
<el-checkbox label="选中且禁用" disabled></el-checkbox>
|
|
</el-checkbox-group>
|
|
</template>
|
|
|
|
<script>
|
|
export default {
|
|
data () {
|
|
return {
|
|
checkList: ['选中且禁用','复选框 A']
|
|
};
|
|
}
|
|
};
|
|
</script>
|
|
```
|
|
:::
|
|
|
|
### Checkbox Attributes
|
|
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
|
|---------- |-------- |---------- |------------- |-------- |
|
|
| label | 选中状态的值（只有在`checkbox-group`或者绑定对象类型为`array`时有效）| string | — | — |
|
|
| true-label | 选中时的值 | string, number | — | — |
|
|
| false-label | 没有选中时的值 | string, number | — | — |
|
|
| name | 原生 name 属性 | string | — | — |
|
|
| disabled | 按钮禁用 | boolean | — | false |
|
|
| checked | 当前是否勾选 | boolean | — | false |
|
|
| indeterminate | 设置 indeterminate 状态，只负责样式控制 | boolean | — | false |
|
|
|
|
### Checkbox-group Events
|
|
| 事件名称 | 说明 | 回调参数 |
|
|
|---------- |-------- |---------- |
|
|
| change | 当绑定值变化时触发的事件 | event 事件对象 |
|