uxcore-select2
v0.5.10
Published
select ui component for react
Downloads
118
Readme
uxcore-select2
TL;DR
uxcore-select2 ui component for react
setup develop environment
$ git clone https://github.com/uxcore/uxcore-select2
$ cd uxcore-select2
$ npm install
$ npm start
Usage
var Select = require('uxcore-select2');
<Select>
<Option value="lucy">lucy</Option>
</Select>
demo
http://uxcore.github.io/select/
Props
Select props
|参数|说明|类型|默认值|
|---|----|---|------|
|value | 指定当前选中的条目 | string/Array | 无 |
|defaultValue | 指定默认选中的条目 | string/Array | 无 |
|multiple | 支持多选 | bool | false |
|filterOption | 是否根据输入结果过滤选项,默认是使用 optionFilterProp 对应的 Option 属性来过滤 | bool/function(inputValue, Option) | true |
|showSearch | 是否在单选模式下显示搜索 | bool | true |
|tags | 可以把随意输入的条目作为tag,输入项不需要与下拉选项匹配 | bool | false |
|onSelect | 被选中时调用,参数为选中的option value值 | function(value, option:Option) | 无 |
|onDeselect | 取消选中时调用,参数为选中的option value值,仅在multiple或tags模式下生效 | function(value) | 无 |
|onChange | 选中option,或input的value变化(combobox模式下)时,调用此函数 | function | 无 |
|onSearch | 搜索框值发生变化时调用 | function(key) | noop |
|allowClear | 显示清除按钮 | | false |
|placeholder | 选择框默认文字 | string | 无 |
|searchPlaceholder | 搜索框默认文字 | string | 无 |
|optionFilterProp | 输入项过滤对应的 option 属性 | string | value |
|combobox | 输入框自动提示模式 | bool | false |
|optionLabelProp| 选择 Option 的哪个 prop 作为选择框中的显示。| string | 'children' |
|getPopupContainer| 弹出的菜单渲染在哪个容器中 | function(trigger:Node):Node | function(){return document.body;}|
|dropdownMatchSelectWidth|dropdown 部分是否和 select 部分同宽| boolean | true |
|dropdownClassName | dropdown 部分的定制类名 | string | - |
|notFoundContent | 未找到选项时的提示文案 | string | not found |
|size | 尺寸,枚举值 large
, small
, middle
| string | large |
Option props
|参数|说明|类型|默认值| |---|----|---|------| |disabled | 是否禁用 | Boolean | false | |key | 如果react需要你设置此项,此项值与value的值相同,然后可以省略value设置 | String | | |value | 默认根据此属性值进行筛选 | String | - | |title | 如果你不满意自动生成的 title,你可以用这个 prop 来修改 | String | - |
OptGroup props
|参数|说明|类型|默认值| |---|----|---|------| |label | 组名 | String/React.Element | 无 | |key | | String | - |