主题
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 | 节点展开图标,优先级高于icon | string | Component | - |
collapse-icon | 节点收起图标,优先级高于icon | string | Component | - |
debounce | 输入框防抖时间,单位ms | number | 500 |
class-name | 自定义节点类名 | string | - |
node-style | 自定义节点样式 | object | - |
cacheData | 懒加载节点的缓存数据,结构与数据相同,用于获取未加载数据的标签 | array | - |
use-folder-icon | 是否使用默认文件夹图标,开启后会根据当前节点的展开/收起状态显示相应的文件夹图标,优先级低于props.icon、props.expandIcon以及props.collapseIcon | boolean | false |