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

TreeSelect

• category: Components
• chinese: 树选择
• type: 表单

---

树型选择控件。

何时使用

类似 Select 的选择控件，可选择的数据结构是一个树形结构时，可以使用 TreeSelect，例如公司层级、学科系统、分类目录等等。

API

Tree props

参数	说明	类型	默认值
value	指定当前选中的条目	string/Array	无
defaultValue	指定默认选中的条目	string/Array	无
multiple	支持多选	boolean	false
tags	可以把随意输入的条目作为 tag，输入项不需要与下拉选项匹配	boolean	false
onSelect	被选中时调用，参数为选中项的 value 值	function(value)	无
onChange	选中option，或input的value变化(combobox 模式下)时，调用此函数	function(value, label)	无
allowClear	显示清除按钮	boolean	false
onSearch	文本框值变化时回调	function(value: String)
placeholder	选择框默认文字	string	无
searchPlaceholder	搜索框默认文字	string	无
dropdownStyle	下拉菜单的样式	object	无
dropdownMatchSelectWidth	下拉菜单和选择器同宽	boolean	true
combobox	输入框自动提示模式	boolean	false
size	选择框大小，可选 large small	String	default
showSearch	在下拉中显示搜索框	boolean	false
disabled	是否禁用	boolean	false
treeDefaultExpandAll	默认展开所有树节点	bool	false
treeCheckable	显示checkbox	bool	false
filterTreeNode	是否根据输入项进行筛选，返回值true	function(treeNode)	-
treeNodeFilterProp	输入项过滤对应的 treeNode 属性	String	'value'
treeNodeLabelProp	作为显示的prop设置	String	'title'
treeData	treeNodes数据，如果设置则不需要手动构造TreeNode节点（如果value在整个树范围内不唯一，需要设置key其值为整个树范围内的唯一id	array<{value, label, children}>	[]
loadData	异步加载数据	function(node)	-

TreeNode props

建议使用 treeData 来代替 TreeNode，免去手工构造麻烦

参数	说明	类型	默认值
disabled	是否禁用	Boolean	false
key	此项必须设置（其值在整个树范围内唯一）	String	-
value	默认根据此属性值进行筛选	String	-
title	树节点显示的内容	String	'---'
isLeaf	是否是叶子节点	bool	false