ant-design/components/select/index.md

36 lines
1.3 KiB
Markdown
Raw Normal View History

2015-05-27 15:43:29 +08:00
# Select
2015-06-02 12:11:49 +08:00
- category: Components
2015-06-14 17:54:08 +08:00
- chinese: 选择器
2015-07-20 12:28:36 +08:00
- order: 5
2015-05-27 15:43:29 +08:00
---
2015-06-14 17:54:08 +08:00
类似 Select2 的选择器。
## 何时使用
弹出一个下拉菜单给用户选择操作,用于代替原生的选择器,或者需要一个更优雅的多选器时。
2015-06-09 21:16:59 +08:00
```html
<Select>
<Option value="lucy">lucy</Option>
</Select>
```
## API
| 参数 | 说明 | 类型 | 默认值 |
|----------|----------------|----------|--------------|
2015-06-15 17:17:23 +08:00
| 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 |
2015-07-21 11:05:11 +08:00
| placeholder | 选择框默认文字 | string | 无 |
| searchPlaceholder | 搜索框默认文字 | string | 无 |
2015-06-16 20:07:43 +08:00
| combobox | 输入框自动提示模式 | | false |