@beisen-phoenix/multi-select-list
v3.3.55
Published
## 注意:该组件即将废弃,我们将不再新增特性。如需使用新特性请替换为该组件:@beisen-phoenix/select-list
Downloads
392
Readme
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 |