# Checkbox Group 复选框组

[toc]

该组件可与`Checkbox`一同使用，提供复选框组的功能。

## 组件引入

在`app.json`或在`index.json`中引入：

```json

{
  "usingComponents": {
    "tea-checkbox-group": "../dist/checkbox-group/index"
  }
}

```

## 用法

用法可参见[`checkbox`](/mp/packages/checkbox/#用法)。

## Props

| 参数            | 描述                   | 类型             | 默认值     | 可选值                                   |
| ------------- | -------------------- | -------------- | ------- | ------------------------------------- |
| value         | 传入的值                 | `Array,String` | -       | -                                     |
| single        | 是否为单选模式              | `Boolean`      | `false` | -                                     |
| outline       | 是否为框线模式              | `Boolean`      | `false` | -                                     |
| square        | 是否为方形                | `Boolean`      | `false` | -                                     |
| display       | 子元素复选框的display 值     | `String`       | `block` | `['inline', 'inline-block', 'block']` |
| selectPattern | 在 Select 组件中使用时，开启此项 | `Boolean`      | `false` | -                                     |

## 事件

| 事件名    | 说明           | 回调参数   |
| ------ | ------------ | ------ |
| change | 当绑定值变化时触发的事件 | 当前选中的值 |
| click  | 点击子复选框时触发    | 当前选中的值 |

## 外部样式类

| 类名          | 描述       |
| ----------- | -------- |
| `ext-class` | 组件根节点样式类 |