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 |