Skip to content

Tree 树形控件

用清晰的层级结构展示信息,可展开或折叠。

基础用法

基础的树形结构展示。

可选择 (Checkbox)

适用于需要选择层级数据的场景。

连接线 (Connection Lines)

特色功能:开启 show-line 属性后,会显示连接线辅助浏览。

自定义图标

可以自定义展开/折叠图标,甚至可以根据节点状态显示不同图标。

自定义节点内容

使用 default 插槽自定义节点内容。

API

Tree Attributes

属性名说明类型默认值
data展示数据array[]
empty-text内容为空的时候展示的文本string-
node-key每个树节点用来作为唯一标识的属性,整棵树应该是唯一的stringid
props配置选项,具体看下表object-
show-checkbox节点是否可被选择booleanfalse
show-line是否显示连接线booleanfalse
default-expanded-keys默认展开的节点的 key 的数组array[]
default-checked-keys默认勾选的节点的 key 的数组array[]
accordion是否每次只打开一个同级树节点展开booleanfalse
indent相邻级节点间的水平缩进,单位为像素number18
icon自定义树节点的图标Component-
expand-on-click-node是否在点击节点的时候展开或者收缩节点booleantrue

Props Attributes

属性名说明类型默认值
label指定节点标签为节点对象的某个属性值string, function(data, node)label
children指定子树为节点对象的某个属性值stringchildren
disabled指定节点选择框是否禁用为节点对象的某个属性值boolean, function(data, node)disabled
isLeaf指定节点是否为叶子节点boolean, function(data, node)isLeaf

Tree Events

事件名说明回调参数
node-click节点被点击时的回调(data: object)
node-expand节点被展开时触发的事件(data: object)
node-collapse节点被关闭时触发的事件(data: object)
check-change节点选中状态发生变化时的回调(data: object, checked: boolean)

Tree Slots

插槽名说明
default自定义树节点的内容,参数为 '{ node, data }'