@beisen-phoenix/multi-select-list

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	无	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 |