Skip to content

TreeSelect 树形选择

使用

含有下拉菜单的树形选择器,结合了 k-tree 和 k-select 两个组件的功能。

基础用法

树状选择器

选择任意级别

当属性check-strictly=true时,任何节点都可以被选择,否则只有子节点可被选择。

TIP

当使用 show-checkbox时,由于 check-on-click-node 默认值是 false,这时候只能通过 checkbox 来选中,当然您也可以将其设置成 true,这样点击整个 node 都可以用来完成选择

多选

通过点击或复选框选择多个选项。

禁用选项

使用 disabled 字段禁用选项。

可筛选

使用关键字筛选或自定义筛选方法。 filterMethod可以自定义数据筛选的方法, filterNodeMethod可以自定义节点数据筛选的方法。

自定义内容

自定义树节点的内容。

内置Icon

基于许多场景需要使用文件夹的展开、收起以及叶子节点图标,因此提供了内置文件夹图标,通过use-folder-icon属性可以开启,优先级低于props提供的icon、expandIcon、collapseIcon属性。

自定义Icon

自定义树节点的Icon。

懒加载

树节点懒加载,更加适合于数据量大的列表。

TIP

由于这个组件是k-tree和k-select的结合体,他们的原始属性未被更改,故不在此重复。请跳转查看原组件的相应文档。

API

TreeSelect Props

参数名描述类型默认值
icon节点图标string | Component-
expand-icon节点展开图标,优先级高于iconstring | Component-
collapse-icon节点收起图标,优先级高于iconstring | Component-
debounce输入框防抖时间,单位msnumber500
class-name自定义节点类名string-
node-style自定义节点样式object-
cacheData懒加载节点的缓存数据,结构与数据相同,用于获取未加载数据的标签array-
use-folder-icon 是否使用默认文件夹图标,开启后会根据当前节点的展开/收起状态显示相应的文件夹图标,优先级低于props.icon、props.expandIcon以及props.collapseIconbooleanfalse