element/examples/docs/checkbox.md

Checkbox 多选框

一组备选项中进行多选

基础用法

单独使用可以表示两种状态之间的切换

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

<template>
  <!-- `checked` 为 true 或 false -->
  <el-checkbox class="checkbox" v-model="checked">备选项</el-checkbox>
</template>
<script>
  export default {
    data() {
      return {
        checked: true
      };
    }
  };
</script>

:::

禁用状态

多选框不可用状态。

::: demo 设置disabled属性即可。

<template>
  <el-checkbox class="checkbox" v-model="checked1" disabled>备选项</el-checkbox>
  <el-checkbox class="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与数组中的元素值相对应，如果存在指定的值则为选中状态，否则为不选中。

<template>
  <el-checkbox-group v-model="checkList">
    <el-checkbox class="checkbox" label="复选框 A"></el-checkbox>
    <el-checkbox class="checkbox" label="复选框 B"></el-checkbox>
    <el-checkbox class="checkbox" label="复选框 C"></el-checkbox>
    <el-checkbox class="checkbox" label="禁用" disabled></el-checkbox>
    <el-checkbox class="checkbox" label="选中且禁用" disabled></el-checkbox>
  </el-checkbox-group>
</template>

<script>
  export default {
    data () {
      return {
        checkList: ['选中且禁用','复选框 A']
      };
    }
  };
</script>

:::

可切换值的多选框

多选框单独时，除了可以表示为是否选中的逻辑值以外，你还可以设定其选中和未选中所表示的值。

:::demo 使用true-label和false-label可以自定义选中时和未选中时的值，可以为String或Number类型。

<template>
  <el-checkbox
    class="checkbox"
    v-model="isValid"
    true-label="可用"
    false-label="不可用">
    {{isValid}}
  </el-checkbox>
</template>
<script>
  export default {
    data() {
      return {
        isValid: '可用'
      };
    }
  };
</script>

:::

Checkbox Attributes

参数	说明	类型	可选值	默认值
label	选中状态的值（只有在checkbox-group下有意义）	string	—	—
true-label	选中时的值	string, number	—	—
false-label	没有选中时的值	string, number	—	—
disabled	按钮禁用	boolean	—	false

Checkbox-group Events

事件名称	说明	回调参数
change	当绑定值变化时触发的事件	选中的 Checkbox Label 值