You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
# Select
- category: Components
- chinese: 选择器
- order: 5
---
类似 Select2 的选择器。
## 何时使用
弹出一个下拉菜单给用户选择操作,用于代替原生的选择器,或者需要一个更优雅的多选器时。
```html
< Select >
< Option value = "lucy" > lucy</ Option >
</ Select >
```
## API
### Select props
| 参数 | 说明 | 类型 | 默认值 |
|----------|----------------|----------|--------------|
| value | 指定默认选中的条目 | string/Array< String > | 无 |
| multiple | 支持多选 | | false |
| filterOption | 是否根据输入项进行筛选 | | true |
| tags | 可以把随意输入的条目作为tag, 输入项不需要与下拉选项匹配 | |false |
| onSelect | 被选中时调用, 参数为选中的option value值 | function | 无 |
| onDeselect | 取消选中时调用, 参数为选中的option value值, 仅在multiple或tags模式下生效 | function | 无 |
| onChange | 选中option, 或input的value变化(combobox模式下)时,调用此函数 | function | 无 |
| allowClear | 显示清除按钮 | | false |
| placeholder | 选择框默认文字 | string | 无 |
| searchPlaceholder | 搜索框默认文字 | string | 无 |
| combobox | 输入框自动提示模式 | | false |
### Option props
| 参数 | 说明 | 类型 | 默认值 |
|----------|----------------|----------|--------------|
| disabled | 是否禁用 | Boolean | false |
| key | 如果react需要你设置此项, 此项值与value的值相同, 然后可以省略value设置 | String | |
| value | 默认根据此属性值进行筛选 | String | - |
### OptGroup props
| 参数 | 说明 | 类型 | 默认值 |
|----------|----------------|----------|--------------|
| label | 组名 | String/React.Element | 无 |
| key | | String | - |