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 | | lang | 当前语言环境(zh_CN,en_US,zh_TW) | string | zh_CN | 否 |
|
28 |
|
29 | ## item
|
30 |
|
31 | 传人的数据是数组,每一项的结构如下:
|
32 |
|
33 | | 参数 | 说明 | 类型 | 默认值 | 必须 |
|
34 | | -------- | -------------- | ------- | ------ | ---- |
|
35 | | label | 实际显示的文案 | String | 无 | Yes |
|
36 | | value | 选项的实际值 | String | 无 | Yes |
|
37 | | disabled | 禁止该选项 | boolean | false | No |
|
38 |
|
39 | ## 多语言
|
40 |
|
41 | | 参数 | 说明 | 类型 | 默认值 | 必须 |
|
42 | | ----------- | --------------------------- | --------------------- | ----------------------- | ---- |
|
43 | | translation | 语言包 用于翻译组件内置常量 | {placeHolder: string} | {placeHolder: '请选择'} | NO |
|
44 |
|
45 | ### 2019-08-27
|
46 |
|
47 | 1. 修改交互,单选可输入选择器,激活输入框时,当前选中项变为提示文字 http://nature.beisen.co/NaturedesignSpec/Naturedesign3.0/NaturedesignSpec-PC/preview/%5bPC%5dNaturedesign3.0.5/4DataEntry-05-Selector/
|
48 | 2. 修改交互,单选可输入选择器,激活输入框时,点击清空,输入框保持激活
|
49 | 3. 添加 showDelete,是否显示清空图标
|
50 |
|
51 | ### 2019-11-19
|
52 |
|
53 | > 新增 lang 属性,用于表示当前的语言环境,取值范围为“zh_CN,zh_TW,en_US”内部新增中文简体、英文、中文繁体语言包。
|
54 |
|
55 | ### 2019-09-26
|
56 |
|
57 | 需要外部控制激活态【边框高亮】,除点击可输入框激活时会高亮外,内部不处理可输入及不可输入激活失焦问题
|
58 | | isActive | 是否处于边框高亮状态 | Boolean | false | No |
|
59 |
|
60 | ### 2019-09-17
|
61 |
|
62 | 新增
|
63 | | suffix | 后缀元素,用于替换下拉箭头 | React.ReactNode | - | 否 |
|