---
title: Checkbox 复选框
description: 多选框是一个选择控件，允许用户通过单击在选中和未选中之间切换。
isComponent: true
usage: true
spline: navigation
author: swimly
---

## 基本用法

复选框有三种状态：未选中，半选（`indeterminate`），选中（`checked`），默认情况为未选中状态，通过`label`可定义复选框的文
本，效果同 default slot。

{{ base }}

## 多选框组

实际应用中单个复选框的使用场景还是较少，通过都会配合`l-checkbox-group`来组成一个多选组，通
过`value`，`defaultValue`，`v-model`可设置默认选中。

> 提示：通过·v-model 绑定的值为响应式（推荐），通过`value`绑定之后整个复选组都不能进行操作，常用于静态展示
> ，`defaultValue`为默认选中，并且不影响后续的操作，常可用作默认值。·

{{ group }}

## 多选组（option）

除了上面的标签方式渲染一组复选框，也可通过`option`来设置一组复选框，`label`属性定义复选文本，`value`设置选中后的值。

{{ option }}

## 限制选中数量 && 禁用

通过`max`可设置一组复选框最多可选多少个，只有当此值小于复选的个数才有效。<br /> 通过 `disabled` 属性可以单个选项及其组件
的禁用状态。

{{ max }}

## 全选

通过`checked`和`checkAll`属性可定义一组带全选功能的复选框组，具体实现方法请参考如下示例。

{{ all }}
