Checkbox 多选框

一组备选项中进行多选

基础用法

单独使用可以表示两种状态之间的切换,写在标签中的内容为 checkbox 按钮后的介绍。

Checkbox 多选框 - 图1

el-checkbox元素中定义v-model绑定变量,单一的checkbox中,默认绑定变量的值会是Boolean,选中为true

  1. <template>
  2. <!-- `checked` 为 true 或 false -->
  3. <el-checkbox v-model="checked">备选项</el-checkbox>
  4. </template>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. checked: true
  10. };
  11. }
  12. };
  13. </script>

禁用状态

多选框不可用状态。

Checkbox 多选框 - 图2

设置disabled属性即可。

  1. <template>
  2. <el-checkbox v-model="checked1" disabled>备选项1</el-checkbox>
  3. <el-checkbox v-model="checked2" disabled>备选项</el-checkbox>
  4. </template>
  5. <script>
  6. export default {
  7. data() {
  8. return {
  9. checked1: false,
  10. checked2: true
  11. };
  12. }
  13. };
  14. </script>

多选框组

适用于多个勾选框绑定到同一个数组的情景,通过是否勾选来表示这一组选项中选中的项。

Checkbox 多选框 - 图3

checkbox-group元素能把多个 checkbox 管理为一组,只需要在 Group 中使用v-model绑定Array类型的变量即可。 el-checkboxlabel属性是该 checkbox 对应的值,若该标签中无内容,则该属性也充当 checkbox 按钮后的介绍。label与数组中的元素值相对应,如果存在指定的值则为选中状态,否则为不选中。

  1. <template>
  2. <el-checkbox-group v-model="checkList">
  3. <el-checkbox label="复选框 A"></el-checkbox>
  4. <el-checkbox label="复选框 B"></el-checkbox>
  5. <el-checkbox label="复选框 C"></el-checkbox>
  6. <el-checkbox label="禁用" disabled></el-checkbox>
  7. <el-checkbox label="选中且禁用" disabled></el-checkbox>
  8. </el-checkbox-group>
  9. </template>
  10. <script>
  11. export default {
  12. data () {
  13. return {
  14. checkList: ['选中且禁用','复选框 A']
  15. };
  16. }
  17. };
  18. </script>

indeterminate 状态

indeterminate 属性用以表示 checkbox 的不确定状态,一般用于实现全选的效果

Checkbox 多选框 - 图4

  1. <template>
  2. <el-checkbox :indeterminate="isIndeterminate" v-model="checkAll" @change="handleCheckAllChange">全选</el-checkbox>
  3. <div style="margin: 15px 0;"></div>
  4. <el-checkbox-group v-model="checkedCities" @change="handleCheckedCitiesChange">
  5. <el-checkbox v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox>
  6. </el-checkbox-group>
  7. </template>
  8. <script>
  9. const cityOptions = ['上海', '北京', '广州', '深圳'];
  10. export default {
  11. data() {
  12. return {
  13. checkAll: false,
  14. checkedCities: ['上海', '北京'],
  15. cities: cityOptions,
  16. isIndeterminate: true
  17. };
  18. },
  19. methods: {
  20. handleCheckAllChange(val) {
  21. this.checkedCities = val ? cityOptions : [];
  22. this.isIndeterminate = false;
  23. },
  24. handleCheckedCitiesChange(value) {
  25. let checkedCount = value.length;
  26. this.checkAll = checkedCount === this.cities.length;
  27. this.isIndeterminate = checkedCount > 0 && checkedCount < this.cities.length;
  28. }
  29. }
  30. };
  31. </script>

可选项目数量的限制

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

Checkbox 多选框 - 图5

  1. <template>
  2. <el-checkbox-group
  3. v-model="checkedCities"
  4. :min="1"
  5. :max="2">
  6. <el-checkbox v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox>
  7. </el-checkbox-group>
  8. </template>
  9. <script>
  10. const cityOptions = ['上海', '北京', '广州', '深圳'];
  11. export default {
  12. data() {
  13. return {
  14. checkedCities: ['上海', '北京'],
  15. cities: cityOptions
  16. };
  17. }
  18. };
  19. </script>

按钮样式

按钮样式的多选组合。

Checkbox 多选框 - 图6

只需要把el-checkbox元素替换为el-checkbox-button元素即可。此外,Element Plus 还提供了size属性。

  1. <template>
  2. <div>
  3. <el-checkbox-group v-model="checkboxGroup1">
  4. <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
  5. </el-checkbox-group>
  6. </div>
  7. <div style="margin-top: 20px">
  8. <el-checkbox-group v-model="checkboxGroup2" size="medium">
  9. <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
  10. </el-checkbox-group>
  11. </div>
  12. <div style="margin-top: 20px">
  13. <el-checkbox-group v-model="checkboxGroup3" size="small">
  14. <el-checkbox-button v-for="city in cities" :label="city" :disabled="city === '北京'" :key="city">{{city}}</el-checkbox-button>
  15. </el-checkbox-group>
  16. </div>
  17. <div style="margin-top: 20px">
  18. <el-checkbox-group v-model="checkboxGroup4" size="mini" disabled>
  19. <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
  20. </el-checkbox-group>
  21. </div>
  22. </template>
  23. <script>
  24. const cityOptions = ['上海', '北京', '广州', '深圳'];
  25. export default {
  26. data () {
  27. return {
  28. checkboxGroup1: ['上海'],
  29. checkboxGroup2: ['上海'],
  30. checkboxGroup3: ['上海'],
  31. checkboxGroup4: ['上海'],
  32. cities: cityOptions
  33. };
  34. }
  35. }
  36. </script>

带有边框

Checkbox 多选框 - 图7

设置border属性可以渲染为带有边框的多选框。

  1. <template>
  2. <div>
  3. <el-checkbox v-model="checked1" label="备选项1" border></el-checkbox>
  4. <el-checkbox v-model="checked2" label="备选项2" border></el-checkbox>
  5. </div>
  6. <div style="margin-top: 20px">
  7. <el-checkbox v-model="checked3" label="备选项1" border size="medium"></el-checkbox>
  8. <el-checkbox v-model="checked4" label="备选项2" border size="medium"></el-checkbox>
  9. </div>
  10. <div style="margin-top: 20px">
  11. <el-checkbox-group v-model="checkboxGroup1" size="small">
  12. <el-checkbox label="备选项1" border></el-checkbox>
  13. <el-checkbox label="备选项2" border disabled></el-checkbox>
  14. </el-checkbox-group>
  15. </div>
  16. <div style="margin-top: 20px">
  17. <el-checkbox-group v-model="checkboxGroup2" size="mini" disabled>
  18. <el-checkbox label="备选项1" border></el-checkbox>
  19. <el-checkbox label="备选项2" border></el-checkbox>
  20. </el-checkbox-group>
  21. </div>
  22. </template>
  23. <script>
  24. export default {
  25. data () {
  26. return {
  27. checked1: true,
  28. checked2: false,
  29. checked3: false,
  30. checked4: true,
  31. checkboxGroup1: [],
  32. checkboxGroup2: []
  33. };
  34. }
  35. }
  36. </script>

Checkbox Attributes

参数说明类型可选值默认值
value / v-model绑定值string / number / boolean
label选中状态的值(只有在checkbox-group或者绑定对象类型为array时有效)string / number / boolean
true-label选中时的值string / number
false-label没有选中时的值string / number
disabled是否禁用booleanfalse
border是否显示边框booleanfalse
sizeCheckbox 的尺寸,仅在 border 为真时有效stringmedium / small / mini
name原生 name 属性string
checked当前是否勾选booleanfalse
indeterminate设置 indeterminate 状态,只负责样式控制booleanfalse

Checkbox Events

事件名称说明回调参数
change当绑定值变化时触发的事件更新后的值

Checkbox-group Attributes

参数说明类型可选值默认值
value / v-model绑定值array
size多选框组尺寸,仅对按钮形式的 Checkbox 或带有边框的 Checkbox 有效stringmedium / small / mini
disabled是否禁用booleanfalse
min可被勾选的 checkbox 的最小数量number
max可被勾选的 checkbox 的最大数量number
text-color按钮形式的 Checkbox 激活时的文本颜色string#ffffff
fill按钮形式的 Checkbox 激活时的填充色和边框色string#409EFF

Checkbox-group Events

事件名称说明回调参数
change当绑定值变化时触发的事件更新后的值

Checkbox-button Attributes

参数说明类型可选值默认值
label选中状态的值(只有在checkbox-group或者绑定对象类型为array时有效)string / number / boolean
true-label选中时的值string / number
false-label没有选中时的值string / number
disabled是否禁用booleanfalse
name原生 name 属性string
checked当前是否勾选booleanfalse