---
title: CheckboxPopout
subtitle: 复选弹出框
group: 表单组件
version: 1.16+
---

## 介绍

组合了复选框组、列表、弹出框组件，实现了在弹出框中多选的功能。

## 引入

```js
import CheckboxPopout from 'sard-uniapp/components/checkbox-popout/checkbox-popout.vue'
```

## 代码演示

### 基础使用

使用 `v-model` 双向绑定当前值，使用 `v-model:visible` 控制弹出框显隐。

<<< @demo/checkbox-popout/demo/Basic.vue

### 全选 <sup>1.20+</sup>

使用 `show-check-all` 显示全选框，可用于快速选择所有或取消选择。

<<< @demo/checkbox-popout/demo/CheckAll.vue

### 禁用选项 <sup>1.20+</sup>

设置了 `disabled` 的选项可禁止选择。

<<< @demo/checkbox-popout/demo/Disabled.vue

### 可搜索的 <sup>1.20+</sup>

使用 `searchable` 显示搜索框，可用于过滤选项列表。

<<< @demo/checkbox-popout/demo/Search.vue

## API

### CheckboxPopoutProps

继承 [`CheckboxGroupProps`](./checkbox#CheckboxGroupProps) 并有以下额外属性：

| 属性                                | 描述                             | 类型              | 默认值 |
| ----------------------------------- | -------------------------------- | ----------------- | ------ |
| popout-class                        | 弹窗框根元素类名                 | string            | -      |
| popout-style                        | 弹窗框根元素样式                 | StyleValue        | -      |
| visible (v-model)                   | 是否显示弹出框                   | boolean           | -      |
| title                               | 弹出框标题                       | string            | -      |
| show-check-all <sup>1.20+</sup>     | 是否显示全选                     | boolean           | false  |
| searchable <sup>1.20+</sup>         | 是否可搜索                       | boolean           | false  |
| filter-placeholder <sup>1.20+</sup> | 搜索输入框占位符内容             | string            | -      |
| resettable <sup>1.23.3+</sup>       | 关闭弹出框后，是否可复位弹出框值 | boolean           | false  |
| icon-position <sup>1.24.1+</sup>    | 可定义复选框的位置               | 'left' \| 'right' | 'left' |

### CheckboxPopoutEmits

| 事件                               | 描述                        | 类型                                  |
| ---------------------------------- | --------------------------- | ------------------------------------- |
| update:model-value                 | 复选输入组件值改变时触发    | `(value: any[] \| undefined) => void` |
| change <sup>1.9.2+</sup>           | 复选输入组件值改变时触发    | `(value: any[] \| undefined) => void` |
| update:visible                     | 弹出框显隐时触发            | `(visible: boolean) => void`          |
| confirm <sup>1.22.1+</sup>         | 点击确定按钮时触发          | `() => void`                          |
| visible-hook <sup>1.22.1+</sup>    | 入场/退场动画状态改变时触发 | `(name: TransitionHookName) => void`  |
| before-enter <sup>1.22.1+</sup>    | 入场动画开始前触发          | `() => void`                          |
| enter <sup>1.22.1+</sup>           | 入场动画开始时触发          | `() => void`                          |
| after-enter <sup>1.22.1+</sup>     | 入场动画结束时触发          | `() => void`                          |
| enter-cancelled <sup>1.22.1+</sup> | 入场动画取消时触发          | `() => void`                          |
| before-leave <sup>1.22.1+</sup>    | 退场动画开始前触发          | `() => void`                          |
| leave <sup>1.22.1+</sup>           | 退场动画开始时触发          | `() => void`                          |
| after-leave <sup>1.22.1+</sup>     | 退场动画结束时触发          | `() => void`                          |
| leave-cancelled <sup>1.22.1+</sup> | 退场动画取消时触发          | `() => void`                          |

## 主题定制

### CSS 变量

<<< @comp/checkbox-popout/variables.scss#variables