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

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

    禁用状态

    多选框不可用状态。

    Checkbox 多选框 - 图2

    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. return {
    8. checked1: false,
    9. checked2: true
    10. };
    11. }
    12. };
    13. </script>

    多选框组

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

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

    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. checkAll: false,
    13. checkedCities: ['上海', '北京'],
    14. cities: cityOptions,
    15. isIndeterminate: true
    16. };
    17. },
    18. methods: {
    19. this.checkedCities = val ? cityOptions : [];
    20. this.isIndeterminate = false;
    21. },
    22. handleCheckedCitiesChange(value) {
    23. let checkedCount = value.length;
    24. this.checkAll = checkedCount === this.cities.length;
    25. this.isIndeterminate = checkedCount > 0 && checkedCount < this.cities.length;
    26. }
    27. }
    28. };

    按钮样式

    按钮样式的多选组合。

    Checkbox 多选框 - 图6

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

    <template>
      <div>
        <el-checkbox-group v-model="checkboxGroup1">
          <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
        </el-checkbox-group>
      </div>
      <div style="margin-top: 20px">
        <el-checkbox-group v-model="checkboxGroup2" size="medium">
          <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
        </el-checkbox-group>
      </div>
      <div style="margin-top: 20px">
        <el-checkbox-group v-model="checkboxGroup3" size="small">
          <el-checkbox-button v-for="city in cities" :label="city" :disabled="city === '北京'" :key="city">{{city}}</el-checkbox-button>
        </el-checkbox-group>
      </div>
      <div style="margin-top: 20px">
        <el-checkbox-group v-model="checkboxGroup4" size="mini" disabled>
          <el-checkbox-button v-for="city in cities" :label="city" :key="city">{{city}}</el-checkbox-button>
        </el-checkbox-group>
      </div>
    </template>
    <script>
      const cityOptions = ['上海', '北京', '广州', '深圳'];
      export default {
        data () {
          return {
            checkboxGroup1: ['上海'],
            checkboxGroup2: ['上海'],
            checkboxGroup3: ['上海'],
            checkboxGroup4: ['上海'],
            cities: cityOptions
          };
        }
      }
    </script>
    

    带有边框

    Checkbox Attributes

    Checkbox-group Attributes

    Checkbox-group Events

    Checkbox-button Attributes