| 1 | #Select
|
| 2 |
|
| 3 | ## 概述
|
| 4 |
|
| 5 | select下拉选择框
|
| 6 |
|
| 7 | ## API
|
| 8 |
|
| 9 | | 参数 | 说明 | 类型 | 默认值 | 必须 |
|
| 10 | | --- | --- | --- | --- | --- |
|
| 11 | | size | 选择框的大小，选项（small, normal, large） | String | normal | No |
|
| 12 | | isSearch | 是否开启搜索功能（是否可输入） | Boolean | false | No |
|
| 13 | | value | 当前选择框中显示的选项 | String 或 Array<Item> | 无 | No |
|
| 14 | | showDelete | 单选模式下是否显示清空图标 | Boolean | true | No |
|
| 15 | | isMultiSelect | 是否为多选选择器 | Boolean | false | No |
|
| 16 | | readOnly | 是否只读 | Boolean | false | No |
|
| 17 | | isActive | 是否处于边框高亮状态 | Boolean | false | No |
|
| 18 | | placeHolder | 选择框的占位符 | String | ‘请输入’ | No |
|
| 19 | | disabled | 是否禁用选择器 | boolean | false | No |
|
| 20 | | error | 校验错误 | boolean | false | No |
|
| 21 | | onChange | 选择框的值发生变化后的回调，返回值 （value, searchWord） | Function | 无 | No
|
| 22 | | onDelete | 删除选项后的回调，返回值 （value） | Function | 无 | No
|
| 23 | | onSearch | 可搜索情况下，输入框的值变化后的回调，返回值 （searchWord） | Function | 无 | No
|
| 24 | | extraCls | 自定义组件容器class,一般用于覆盖组件默认样式使用 (2019-09-11新增api) | string | 无 | 否 |
|
| 25 | | onClick | 点击选择器回调 | Function ，返回值(e)| 无 | No
|
| 26 | | suffix | 后缀元素，用于替换下拉箭头 | React.ReactNode | - | 否 |
|
| 27 |
|
| 28 | ## item
|
| 29 |
|
| 30 | 传人的数据是数组，每一项的结构如下：
|
| 31 |
|
| 32 | | 参数 | 说明 | 类型 | 默认值 | 必须 |
|
| 33 | | --- | --- | --- | --- | --- |
|
| 34 | | label | 实际显示的文案 | String | 无 | Yes |
|
| 35 | | value | 选项的实际值 | String | 无 | Yes |
|
| 36 | | disabled | 禁止该选项 | boolean | false | No |
|
| 37 |
|
| 38 |
|
| 39 | ## 多语言
|
| 40 |
|
| 41 | | 参数 | 说明 | 类型 | 默认值 | 必须 |
|
| 42 | | --- | --- | --- | --- | --- |
|
| 43 | | translation | 语言包 用于翻译组件内置常量 | {placeHolder: string} | {placeHolder: '请选择'} | NO |
|
| 44 |
|
| 45 | ### 2019-08-27
|
| 46 | 1. 修改交互，单选可输入选择器，激活输入框时，当前选中项变为提示文字 http://nature.beisen.co/NaturedesignSpec/Naturedesign3.0/NaturedesignSpec-PC/preview/%5bPC%5dNaturedesign3.0.5/4DataEntry-05-Selector/
|
| 47 | 2. 修改交互，单选可输入选择器，激活输入框时,点击清空，输入框保持激活
|
| 48 | 3. 添加showDelete，是否显示清空图标
|
| 49 |
|
| 50 | ### 2019-09-17
|
| 51 | 新增
|
| 52 | | suffix | 后缀元素，用于替换下拉箭头 | React.ReactNode | - | 否 |
|
| 53 |
|
| 54 | ### 2019-09-26
|
| 55 | 需要外部控制激活态【边框高亮】，除点击可输入框激活时会高亮外，内部不处理可输入及不可输入激活失焦问题
|
| 56 | | isActive | 是否处于边框高亮状态 | Boolean | false | No | |
| \ | No newline at end of file |