> @beisen-phoenix/select-list
npm install @beisen-phoenix/select-list> @beisen-phoenix/select-list
###changelog
2019-11-21 3.3.44版本
1、新增 fixHeight：是否固定弹层高度（showSearch为true时，可不设置此属性。解决由于搜索导致列表高度变化的问题，设置为true时，弹层的高度始终为初始时展示的高度，最小高度190px）
| 参数 | 说明 | 类型 | 默认值 | 必须 |
| --- | --- | --- | --- | --- |
| className | 自定义组件容器class,一般用于覆盖组件默认样式使用| string | 无| No |
| size | 下拉框的宽度大小（small：170px, middle:340px, auto) | String | auto | No |
| fontSize | 字体尺寸（small: 12px, large: 14px） | String | small | No |
| showBorder | 是否展示默认边框和阴影 | boolean | false | No |
| options | 当前列表数据 | IOption[] | 无 | Yes |
| selectedOptions | 当前选中项列表 | IOption / IOption[] | 无 | No |
| showSearch | 是否显示搜索框 | boolean | false | No |
| placeholder | 显示搜索框时使用：搜索框中的默认提示文字 | String | 搜索 | No |
| autoFocus | 显示搜索框时使用：首次挂载时是否自动获取焦点 | boolean | false | 否 |
| isLocalSearch | 显示搜索框时使用：是否启用本地搜索，即在当前列表中搜索 | boolean | true | No |
| caseSensitive | 搜索时是否大小写敏感 | boolean | false | 否 |
| keyWords | 不显示搜索框时使用：需要高亮的关键字 | String | 无 | No |
| multiple | 是否多选 | boolean | false | No |
| isGroup | 是否分组 | boolean | false | No |
| showCheckAll | 非分组列表时使用：是否开启全选功能 | boolean | true | No |
| showFooter | 多选时使用：是否显示底部确定按钮 | boolean | false | No |
| loading | 数据是否正在加载中（异步请求数据时使用） | boolean | false | No |
| fixHeight | 是否固定弹层高度（showSearch为true时，可不设置此属性。解决由于搜索导致列表高度变化的问题，设置为true时，弹层的高度始终为初始时展示的高度，最小高度190px） | boolean | false | No |
| onSelect | 点击选项时的回调函数 | (params: ISelectParams, e?: React.MouseEvent) => void | 无 | Yes
| onSearch | 显示搜索框时使用：搜索框内容变化时调用 | (value: string ) => void | 无 | No
| validateSearch | 搜索值自定义验证器 | (val: string) => { value: string, info: string,clearTipAfter?:number } | 无 | No
| onCheckAll | 多选时使用：点击底部确定按钮时回调函数 | ({selectedOptions: ISelectAllParams}) => void | 无 | No
| onConfirm | 显示确定按钮时使用：点击确定的回调函数 | () => void | 无 | No
传人的列表数据是数组，每一项的结构如下：
| 参数 | 说明 | 类型 | 默认值 | 必须 |
| --- | --- | --- | --- | --- |
| label | 实际显示的文案 | String | 无 | Yes |
| value | 选项的实际值 | String 或 Number | 无 | Yes |
| disabled | 禁止该选项 | boolean | false | No |
| selected | 是否选中 | String | 无 | No |
| children | 分组时使用 当前分组下的数据 | String 或 Number | 无 | No |
``javascript`
interface ISelectParams {
selectedOptions?: IOption[] // 复选时 当前所有选中项集合
selectOption?: IOption // 当前点击项
index?: number // 单选时 选中项索引 暂未支持 先不要使用
}
`javascript``
interface ISelectAllParams {
selectedOptions?: IOption[] // 复选时 当前所有选中项集合
}
| 参数 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| translation | 语言包 用于翻译组件内置常量 | | {empty: "这里什么都没有...",confirm: '确定',checkAll: '全选', checkSearchAll: '全选搜索结果', placeholder: '搜索'}