Skip to main content

Tree

When to use

  • Suitable for scenarios with large amounts of hierarchical data, and using component's expand/collapse and associated selection interactions to conveniently manipulate data.

Component Example

Component Properties

属性说明类型默认值
canDrop

Event triggered when checking if node can be used as target node

(info: any) => boolean

-
checkStrictly

Checkbox completely controlled

boolean

false

checkStrictly

Define the way to return when selected, all: return all selected nodes, parent: only return parent node when all parent nodes are selected, child: only return child nodes when all parent nodes are selected

'all' | 'parent' | 'child'

'parent'

checkStrictly

Checkbox completely controlled

boolean

false

checkable

Whether to show checkbox

boolean

false

checkedKeys

Default selected nodes

string[]

['0-0-0']

checkedKeys

Default checked nodes

string[]

["0-0-0"]

dataSource

Node data

TreeDataSource[]

[
{
  key: "0-0",
  label: "0-0",
  children: [
    {
      key: "0-0-0",
      label: "0-0-0",
      children: [
        {
          key: "0-0-0-0",
          label: "0-0-0-0",
          children: [
            {
              key: "0-0-0-0-0",
              label: "0-0-0-0-0",
            },
          ],
        },
        {
          key: "0-0-0-1",
          label: "0-0-0-1",
        },
      ],
    },
    {
      key: "0-0-1",
      label: "0-0-1",
      children: [
        {
          key: "0-0-1-0",
          label: "0-0-1-0",
        },
        {
          key: "0-0-1-1",
          label: "0-0-1-1",
        },
      ],
    },
  ],
},
]
defaultExpandAll

Expand all nodes by default

boolean

true

defaultExpandedKeys

Default expanded nodes

string[]

['0-0-0']

draggable

Whether to support dragging

boolean

false

editable

Whether to support editing

boolean

false

expandedKeys

Expanded nodes

string[]

['0-0-0']

isLoadData

Whether to enable asynchronous loading

boolean

false

loadData

Event triggered when asynchronous loading

(data: TreeDataSource) => Promise<TreeDataSource[]>

-
multiple

Whether to support multiple selection

boolean

false

onCheck

Event triggered when checking or unchecking checkboxes

(checkedKeys: string[], extra: any) => void

-
onDragEnd

Event triggered when drag ends

(info: any) => void

-
onDragEnter

Event triggered when dragging node enters target

(info: any) => void

-
onDragLeave

Event triggered when dragging node leaves target node

(info: any) => void

-
onDragOver

Event triggered when dragging node moves over target node

(info: any) => void

-
onDragStart

Event triggered when starting to drag node

(info: any) => void

-
onDrop

Event triggered when dragging node is dropped into target node or before/after it

(info: any) => void

-
onEditFinish

Event triggered when completing node content editing

(key: string, label: string, node: TreeDataSource) => void

-
onExpand

Event triggered when expanding or collapsing nodes

(expandedKeys: string[], extra: any) => void

-
onSelect

Event triggered when selecting or unselecting nodes

(selectedKeys: string[], extra: any) => void

-
processDataSource

Data preprocessing function

(data: any) => TreeDataSource[]

-
selectable

Whether to support selection

boolean

true

selectedKeys

Default selected nodes

string[]

['0-0-0']

showLine

Whether to show node lines

boolean

true

This doc is generated using machine translation. Any discrepancies or differences created in the translation are not binding and have no legal effect for compliance or enforcement purposes.
© 2014–2025 DingTalk Technology Co., Ltd