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

category	group	title	description	cover	coverDark	demo
Components	Data Entry	TreeSelect	Tree selection control.	https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*1zcHQLltaJcAAAAAAAAAAAAADrJ8AQ/original	https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*hjwGSIa4J8QAAAAAAAAAAAAADrJ8AQ/original	cols 2

When To Use

TreeSelect is similar to Select, but the values are provided in a tree like structure. Any data whose entries are defined in a hierarchical manner is fit to use this control. Examples of such case may include a corporate hierarchy, a directory structure, and so on.

Examples

Basic Multiple Selection Generate from tree data Checkable Asynchronous loading Show Tree Line Placement Status Suffix _InternalPanelDoNotUseOrYouWillBeFired Component Token

API

Common props ref：Common props

Tree props

Property	Description	Type	Default	Version
allowClear	Customize clear icon	boolean | { clearIcon?: ReactNode }	false	5.8.0: Support object type
autoClearSearchValue	If auto clear search input value when multiple select is selected/deselected	boolean	true
defaultValue	To set the initial selected treeNode(s)	string | string[]	-
disabled	Disabled or not	boolean	false
popupClassName	The className of dropdown menu	string	-	4.23.0
popupMatchSelectWidth	Determine whether the popup menu and the select input are the same width. Default set min-width same as input. Will ignore when value less than select width. false will disable virtual scroll	boolean | number	true	5.5.0
dropdownRender	Customize dropdown content	(originNode: ReactNode, props) => ReactNode	-
dropdownStyle	To set the style of the dropdown menu	CSSProperties	-
fieldNames	Customize node label, value, children field name	object	{ label: label, value: value, children: children }	4.17.0
filterTreeNode	Whether to filter treeNodes by input value. The value of treeNodeFilterProp is used for filtering by default	boolean | function(inputValue: string, treeNode: TreeNode) (should return boolean)	function
getPopupContainer	To set the container of the dropdown menu. The default is to create a div element in body, you can reset it to the scrolling area and make a relative reposition. example	function(triggerNode)	() => document.body
labelInValue	Whether to embed label in value, turn the format of value from string to {value: string, label: ReactNode, halfChecked: string[]}	boolean	false
listHeight	Config popup height	number	256
loadData	Load data asynchronously. Will not load when filtering. Check FAQ for more info	function(node)	-
maxTagCount	Max tag count to show. responsive will cost render performance	number | responsive	-	responsive: 4.10
maxTagPlaceholder	Placeholder for not showing tags	ReactNode | function(omittedValues)	-
maxTagTextLength	Max tag text length to show	number	-
multiple	Support multiple or not, will be true when enable treeCheckable	boolean	false
notFoundContent	Specify content to show when no result matches	ReactNode	Not Found
placeholder	Placeholder of the select input	string	-
placement	The position where the selection box pops up	bottomLeft bottomRight topLeft topRight	bottomLeft
searchValue	Work with onSearch to make search value controlled	string	-
showCheckedStrategy	The way show selected item in box when treeCheckable set. Default: just show child nodes. TreeSelect.SHOW_ALL: show all checked treeNodes (include parent treeNode). TreeSelect.SHOW_PARENT: show checked treeNodes (just show parent treeNode)	TreeSelect.SHOW_ALL | TreeSelect.SHOW_PARENT | TreeSelect.SHOW_CHILD	TreeSelect.SHOW_CHILD
showSearch	Support search or not	boolean	single: false | multiple: true
size	To set the size of the select input	large | middle | small	-
status	Set validation status	'error' | 'warning'	-	4.19.0
suffixIcon	The custom suffix icon	ReactNode	<DownOutlined />
switcherIcon	Customize collapse/expand icon of tree node	ReactNode | ((props: AntTreeNodeProps) => ReactNode)	-	renderProps: 4.20.0
tagRender	Customize tag render when multiple	(props) => ReactNode	-
treeCheckable	Whether to show checkbox on the treeNodes	boolean	false
treeCheckStrictly	Whether to check nodes precisely (in the checkable mode), means parent and child nodes are not associated, and it will make labelInValue be true	boolean	false
treeData	Data of the treeNodes, manual construction work is no longer needed if this property has been set(ensure the Uniqueness of each value)	array<{ value, title, children, [disabled, disableCheckbox, selectable, checkable] }>	[]
treeDataSimpleMode	Enable simple mode of treeData. Changes the treeData schema to: [{id:1, pId:0, value:'1', title:"test1",...},...] where pId is parent node's id). It is possible to replace the default id and pId keys by providing object to treeDataSimpleMode	boolean | object<{ id: string, pId: string, rootPId: string }>	false
treeTitleRender	Customize tree node title render	(nodeData) => ReactNode	-	5.12.0
treeDefaultExpandAll	Whether to expand all treeNodes by default	boolean	false
treeDefaultExpandedKeys	Default expanded treeNodes	string[]	-
treeExpandAction	Tree title open logic when click, optional: false | click | doubleClick	string | boolean	false	4.21.0
treeExpandedKeys	Set expanded keys	string[]	-
treeIcon	Shows the icon before a TreeNode's title. There is no default style; you must set a custom style for it if set to true	boolean	false
treeLoadedKeys	(Controlled) Set loaded tree nodes, work with loadData only	string[]	[]
treeLine	Show the line. Ref Tree - showLine	boolean | object	false	4.17.0
treeNodeFilterProp	Will be used for filtering if filterTreeNode returns true	string	value
treeNodeLabelProp	Will render as content of select	string	title
value	To set the current selected treeNode(s)	string | string[]	-
variant	Variants of selector	outlined | borderless | filled	outlined	5.13.0
virtual	Disable virtual scroll when set to false	boolean	true	4.1.0
onChange	A callback function, can be executed when selected treeNodes or input value change	function(value, label, extra)	-
onDropdownVisibleChange	Called when dropdown open	function(open)	-
onSearch	A callback function, can be executed when the search input changes	function(value: string)	-
onSelect	A callback function, can be executed when you select a treeNode	function(value, node, extra)	-
onTreeExpand	A callback function, can be executed when treeNode expanded	function(expandedKeys)	-
onPopupScroll	Called when dropdown scrolls	(event: UIEvent) => void	-	5.17.0

Tree Methods

Name	Description	Version
blur()	Remove focus
focus()	Get focus

TreeNode props

We recommend you to use treeData rather than TreeNode, to avoid the trouble of manual construction.

Property	Description	Type	Default	Version
checkable	When Tree is checkable, set TreeNode display Checkbox or not	boolean	-
disableCheckbox	Disables the checkbox of the treeNode	boolean	false
disabled	Disabled or not	boolean	false
isLeaf	Leaf node or not	boolean	false
key	Required property (unless using treeDataSimpleMode), should be unique in the tree	string	-
selectable	Whether can be selected	boolean	true
title	Content showed on the treeNodes	ReactNode	---
value	Will be treated as treeNodeFilterProp by default, should be unique in the tree	string	-

Design Token

FAQ

How to get parent node in onChange?

We don't provide this since performance consideration. You can get by this way: https://codesandbox.io/s/get-parent-node-in-onchange-eb1608

Why sometime customize Option cause scroll break?

You can ref Select FAQ.

Why loadData not trigger when searching?

In earlier version, loadData will be triggered when searching. But we got feedback that it will block network when inputting. So we change it to not trigger loadData when searching. But you can still handle async logic by filterTreeNode:

<TreeSelect
  filterTreeNode={(input, treeNode) => {
    const match = YOUR_LOGIC_HERE;

    if (match && !treeNode.isLeaf && !treeNode.children) {
      // Do some loading logic
    }

    return match;
  }}
/>

Why can't popup scroll horizontally?

Just turn off virtual scrolling, because the scrollWidth of the complete list cannot be accurately measured when virtual scrolling is turned on.