ant-design/components/select/index.md

Select

• category: Components
• chinese: 选择器
• order: 5

---

类似 Select2 的选择器。

何时使用

弹出一个下拉菜单给用户选择操作，用于代替原生的选择器，或者需要一个更优雅的多选器时。

<Select>
  <Option value="lucy">lucy</Option>
</Select>

API

Select props

参数	说明	类型	默认值
value	指定选中的条目	string/Array	无
defaultValue	指定默认选中的条目	string/Array	无
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	-