Skip to content

TreeSelect 树形选择器

树形选择器组件,将树形结构与下拉选择器结合,用于层级数据的选取。


基础用法

单选树形选择,点击叶子节点完成选择。

vue

<TTreeSelect :data="data" v-model="value" placeholder="请选择" />

多选模式

设置 multiple 开启多选。选中父节点自动联动子节点,子节点部分选中时父节点显示半选状态。

vue

<TTreeSelect :data="data" v-model="values" multiple />

仅末级可选

设置 leaf-only 禁止选择父节点,仅叶子节点可被选中。父节点点击仅展开/折叠。

vue

<TTreeSelect :data="data" leaf-only placeholder="请选择" />

可搜索

设置 filterable 开启搜索过滤,输入关键词快速定位节点。

vue

<TTreeSelect :data="data" filterable placeholder="搜索..." />

折叠标签

多选模式下设置 collapse-tags 将超过 2 个的选中项折叠为 +N 显示。

vue

<TTreeSelect :data="data" multiple collapse-tags />

API

Props

属性类型默认值说明
dataTreeSelectOption[][]树形选项数据
v-modelstring | number | (string | number)[]'' / []选中值
multiplebooleanfalse多选模式
leaf-onlybooleanfalse仅允许选择末级节点
placeholderstring'请选择'占位符
size'sm' | 'lg'尺寸
disabledbooleanfalse禁用
clearablebooleanfalse可清空
filterablebooleanfalse可搜索过滤
collapseTagsbooleanfalse多选时折叠标签
defaultExpandAllbooleanfalse默认展开所有节点
validation'valid' | 'invalid'验证状态
blockbooleanfalse块级宽度

Emits

事件参数说明
changevalue选中值变化

TreeSelectOption

属性类型说明
labelstring显示文本
valuestring | number选项值
childrenTreeSelectOption[]子节点
disabledboolean禁用