树形控件

简介

树形控件组件是一种以树状结构显示层级关系数据的组件,允许用户展开、收缩及选择各个节点以便进行数据浏览和操作。

image

配置项

分类

配置

示例

说明

内容

选项列表

image

树形控件组件数据源。支持手动配置和映射模式。

展开项

image

当前展开的树节点的值。

交互

隐藏

image

控制树型控件组件的默认展示状态,为true 时将隐藏组件。详情参见通用属性

禁用

image

是否禁用树型控件组件

选框

image

是否展示勾选框

拖拽

image

树节点是否支持拖拽

搜索

image

是否展示搜索框

样式

高度

image

组件高度,详情参见通用属性

外边距

image

详情参见通用属性

展示图标

image

是否自定义展开/折叠图标。不开启时采用默认图标

图标模式

image

开启「展示图标」配置时,可选择图标模式

固定图标

image

固定给的三组图标。

自定义图标

image

image

自定义树节点的展开/折叠图标。

如果只设置展开图标,则折叠图标为展开图标逆时针转向90度;只设置折叠图标,则展开图标为折叠图标顺时针转向90度。

节点是否占据一行

image

节点是否会占据整行

展示连接线

image

是否展示树节点之间的连接线。

css样式

节点悬浮态背景色

image

鼠标悬浮在树节点时背景颜色

节点选中态背景色

image

树节点选中时背景颜色

文字颜色

image

树节点文字颜色

搜索匹配文字颜色

image

搜索时树节点匹配上的文字颜色,每个节点仅针对第一次匹配上的文字

属性与方法

名称

类型

示例

说明

treeData

array

tree1.treeData

只读,当前树型控件组件的数据源

expandedKeys

array

tree1.expandedKeys

当前树形控件组件的展开项

checkedKeys

array

tree1.checkedKeys

当前树形控件组件的选中项

disabled

boolean

tree1.disabled

是否禁用当前树型控件组件

showSearch

boolean

tree1.showSearch

是否支持搜索树型控件组件的数据源

checkable

boolean

tree1.checkable

是否展示树节点的选框

draggable

boolean

tree1.draggable

树节点是否支持拖拽

hidden

boolean

tree1.hidden

当前组件是否隐藏,详情参见通用属性

setExpandedKeys

func

tree1.setExpandedKeys(['option1'])

设置树型控件的展开节点的值为option1

clearExpandedKeys

func

tree1.ExpandedKeys()

清除树型控件的展开节点的值

setCheckable

func

tree1.setCheckable(true)

设置树型控件的是否开启选框,参数为truefalse

clearCheckabl

func

tree1.clearCheckabl()

清除树型控件的开启选框状态

setCheckedKeys

func

tree1.setCheckedKeys(['option1'])

开启选框时,设置树型控件的选框选中节点的值为option1

clearCheckedKeys

func

tree1.setCheckedKeys()

清除树型控件的选框选中节点的值

setDraggable

func

tree1.setDraggable(true)

设置树型控件的是否开启拖拽,参数为truefalse

clearDraggable

func

tree1.clearDraggable()

清除树型控件的开启拖拽状态

setDIsabled

func

tree1.setDIsabled(true)

设置树型控件的是否禁用,参数为truefalse

clearDIsabled

func

tree1.clearDIsabled()

清除树型控件的禁用状态

setShowSearch

func

tree1.setShowSearch(true)

设置树型控件的值是否支持过滤数据源,参数为truefalse

clearShowSearch

func

tree1.clearShowSearch()

清除树型控件的支持过滤状态

setHidden

func

tree1.setHidden(false)

设置树型控件是否隐藏,参数为truefalse详情参见通用属性

clearHidden

func

tree1.clearHidden()

清除树型控件的隐藏状态,详情参见通用属性

事件回调

配置

说明

image

当树型控件的选中节点时将触发的事件

image

当展开树节点时将触发的事件

image

当选中树节点选框时将触发的事件

image

当搜索树节点时将触发的事件