跳到主要内容

TreeSelect 树选择 ​

WebH5

树选择器。触发器样式与 Select 一致,下拉面板内嵌 Tree:单选点击节点高亮选中并关闭;multiple 多选时复选框级联勾选(复用 Tree 的 checkable 能力),面板不关闭,触发器以标签展示选中叶子,支持 collapseTags 折叠与 clearable 清空。

何时使用 ​

选项本身是层级结构且需要选中节点(含中间层级)时:组织汇报关系、费用归属部门、多级地区/分类。需要同时看到整棵树并自由勾选时尤其适合多选模式。

何时不使用 ​

扁平选项用 Select;只需要选中一条完整的根到叶子路径(如省市区)时用 Cascader;只展示层级、不需要选择时用 Tree。

Props ​

名称类型默认值说明
modelValuestring | number | Array<string | number> | nullnull绑定值(单选为节点 value,multiple 多选为叶子 value 数组),配合 v-model 使用
optionsArray<TreeSelectOption>[]嵌套选项(与 Tree 节点同构):{ label: string; value: string | number; children?: 同构; disabled?: boolean }
placeholderstring"请选择(取 locale 文案 treeselect.placeholder)"未选中时的占位文本
disabledbooleanfalse禁用
clearablebooleanfalse可清空;有值时 hover 触发器显示清空按钮
multiplebooleanfalse多选模式:复选框级联勾选,勾选父级勾选全部子孙(部分选中时父级半选);面板不关闭,触发器以标签展示选中叶子
collapseTagsbooleanfalse多选时折叠标签:只显示首个标签与 +N 计数
checkablebooleantrue多选时显示复选框;false 时点击节点行切换选中。单选始终为纯点击选中
defaultExpandedKeysArray<string | number>[]首次挂载时展开的节点 key 列表;下拉树的展开态由组件记忆,关闭重开不丢失

Events ​

名称载荷说明
update:modelValuestring | number | Array<string | number> | null选中节点/勾选变化/清空时触发,用于 v-model
changestring | number | Array<string | number> | null值变化时触发(选中节点、勾选变化或清空)
clearvoid点击清空按钮时触发

示例 ​

单选(选择汇报对象) ​

示例加载中…

多选(选择费用归属部门) ​

示例加载中…

单选模式 + 选中值回显 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TreeSelect 文档(含手机预览)。