---
title: checkbox-group
description: 组合多选框
spline: form
isComponent: true
---

### 特性及兼容性

无

## 引入

### 引入组件

在 `app.json` 或 `page.json` 中引入组件：

```json
"usingComponents": {
  "t-checkbox": "tdesign-miniprogram/checkbox/checkbox",
  "t-checkbox-group": "tdesign-miniprogram/checkbox-group/checkbox-group"
}
```

## 用法

### 组件方式

```html
<!-- page.wxml -->
<t-checkbox-group  defaultValue="checkbox1" bind:change="onChange">
  <t-checkbox title="单行标题" value="checkbox1" />
  <t-checkbox title="单行标题" label="辅助信息" value="checkbox2" />
</t-checkbox-group>
```
 <t-checkbox title="单行标题" value="checkbox1" defaultChecked="{{true}}"/>
## API

### `<t-checkbox-group>` 组件

组件路径：`tdesign-miniprogram/checkbox-group/checkbox-group`

#### Props

| 属性     | 值类型    | 默认值 | 必传 | 说明                   |
| -------- | --------- | ------ | ---- | ---------------------- |
| value    | `Array`   | `[]`   | N    | 当前选中项的标识符     |
| name     | `String`  | -      | N    | 在表单内提交时的标识符 |
### Slots

| 名称 | 说明              |
| ---- | ----------------- |
| 默认 | `t-checkbox` 组件 |

#### Events

| 事件        | event.detail               | 说明                     |
| ----------- | -------------------------- | ------------------------ |
| bind:change | {names:当前选中项的标识符} | 当绑定值变化时触发的事件 |