## multi-select-list

## 注意：该组件即将废弃，我们将不再新增特性。如需使用新特性请替换为该组件：@beisen-phoenix/select-list 

## 概述

多选下拉选择框

## API

| 参数 | 说明 | 类型 | 默认值 | 必须 |
| --- | --- | --- | --- | --- |
| size | 下拉框的宽度大小（small：170px, middle:340px, auto) | String | auto | No |
| isSearch | 是否支持搜索功能，支持会有一个搜索框展示出来 | Boolean | false | No |
| items | 下拉框的列表数据 | Array | 无 | Yes |
| fontSize | 字体尺寸（small: 12px, large: 14px） | String | small | No |
| defaultSelectedItems | 当前被选择项的集合 | Array<Item> | 无 | No |
| searchPlaceHolder | 带搜索框模式时，搜索框的占位符 | String | 搜索 | No |
| noBorder | 是否展示默认边框和阴影 | boolean | true | No |
| CustomComponent | 插入自定义组件 | React (JSX.Element) | 无 | No |
| loading | 数据是否正在加载中 | boolean | false | No |
| onChange |  发生状态变化后的回调，返回值 （items: Array） | Function | 无 | No
| showCheckAll | 是否支持开启全选功能 | Boolean | true | No |
| showFooter | 是否显示底部确定按钮 | Boolean | false | No |
| onConfirm |  点击确定按钮回调，返回值 （item: Array) | Function | 无 | No
| validateSearch |  搜索内容校验规则，返回值里的 info 会出现在搜索框下方作为提示信息，val 会被设置为最终输入值, clearTipAfter 多少毫秒后提示消失 | (val: string) => { value: string, info: string,clearTipAfter?:number } | 无 | No
| isGroup | 是否为分组复选 | boolean | false | No |
| caseSensitive | 搜索时是否大小写敏感 (2019-10-14新增api) | boolean | false | 否 |
| autoFocus | 首次挂载时是否自动获取焦点（2019-10-15新增） | boolean | false | 否 |


## items

传人的列表数据是数组，每一项的结构如下：

| 参数 | 说明 | 类型 | 默认值 | 必须 |
| --- | --- | --- | --- | --- |
| label | 实际显示的文案 | String | 无 | Yes |
| value | 选项的实际值 | String 或 number | 无 | Yes |
| disabled | 禁止该选项 | boolean | false | No |

分组数据
| 参数 | 说明 | 类型 | 默认值 | 必须 |
| --- | --- | --- | --- | --- |
| label | 分组标题 | String | 无 | Yes |
| value | 分组值 | String 或 number | 无 | Yes |
| children | 分组下选项 | 同上item | 无 | Yes |

## ChangeLog

### 1.1.21
升级toolitp版本，解决zIndex层级问题


### 2019-07-10
新增api
| extraCls | 自定义组件容器class,一般用于覆盖组件默认样式使用| string | 无| No |
移除 api maxHeight 如需自定义样式 请使用extraCls

### 2019-08-17
新增
| showCheckAll | 是否支持开启全选功能 | Boolean | true | No |
| showFooter | 是否显示底部确定按钮 | Boolean | false | No |
| onConfirm |  点击确定按钮回调，返回值 （item: Array) | Function | 无 | No

### 2019-09-07
新增
| isGroup | 是否为分组复选 | boolean | false | No |