ant-design/components/select/index.en-US.md

category	type	title
Components	Data Entry	Select

Select component to select value from options.

When To Use

• A dropdown menu for choosing, an elegant alternative to the native select component.
• Radio is a better solution when options amount is too little (less than 5).

API

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

Select props

Property	Description	Type	Default
value	Current selected option.	string|string[]	-
defaultValue	Initial selected option.	string|string[]	-
mode	Set mode of Select (Support after 2.9)	'multiple' | 'tags' | 'combobox'	-
multiple	Allow multiple select (Deprecated after 2.9, use mode instead)	boolean	false
tags	When tagging is enabled the user can select from pre-existing options or create a new tag by picking the first choice, which is what the user has typed into the search box so far. (Deprecated after 2.9, use mode instead)	boolean	false
combobox	Enable combobox mode (can not set multiple at the same time). (Deprecated after 2.9, use mode instead)	boolean	false
allowClear	Show clear button.	boolean	false
filterOption	If true, filter options by input, if function, filter options against it. The function will receive two arguments, inputValue and option, if the function returns true, the option will be included in the filtered set; Otherwise, it will be excluded.	boolean or function(inputValue, option)	true
onSelect	Called when a option is selected, the params are option's value (or key) and option instance.	function(value, option)	-
onDeselect	Called when a option is deselected, the params are option's value (or key) . only called for multiple or tags, effective in multiple or tags mode only.	function(value)	-
onChange	Called when select an option or input value change, or value of input is changed in combobox mode	function(value, label)	-
onSearch	Callback function that is fired when input changed.	function(value: string)
onBlur	Called when blur	function	-
onFocus	Called when focus	function	-
placeholder	Placeholder of select	string|ReactNode	-
notFoundContent	Specify content to show when no result matches..	string	'Not Found'
dropdownMatchSelectWidth	Whether dropdown's with is same with select.	boolean	true
optionFilterProp	Which prop value of option will be used for filter if filterOption is true	string	value
optionLabelProp	Which prop value of option will render as content of select.	string	children
size	Size of Select input. default large small	string	default
showSearch	Whether show search input in single mode.	boolean	false
disabled	Whether disabled select	boolean	false
defaultActiveFirstOption	Whether active first option by default	boolean	true
dropdownStyle	style of dropdown menu	object	-
dropdownClassName	className of dropdown menu	string	-
getPopupContainer	Parent Node which the selector should be rendered to. Default to body. When position issues happen, try to modify it into scrollable content and position it relative.example	function(triggerNode)	() => document.body
labelInValue	whether to embed label in value, turn the format of value from string to {key: string, label: ReactNode}	boolean	false
tokenSeparators	Separator used to tokenize on tag/multiple mode	string[]
firstActiveValue	Value of action option by default	string|string[]	-

Option props

Property	Description	Type	Default
disabled	Disable this option	boolean	false
value	default to filter with this property	string	-
key	Same usage as value. If React request you to set this property, you can set it to value of option, and then omit value property.	string
title	title of Select after select this Option	string	-

OptGroup props

Property	Description	Type	Default
label	Group label	string|React.Element	-
key		string	-