Tree 树形组件
规则
基础示例
Props 配置示例
可勾选树
父子节点勾选不关联(checkStrictly)
默认展开全部
整段禁用(节点禁用)
节点数据支持 disabled,勾选树下可禁用对应节点的交互。
Events 事件示例
监听勾选和选中变化
勾选后统计权限数量
完整配置项:TDesign_Tree
value:Array
Props
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| activable | 节点是否可高亮 | boolean | false | - |
| activeMultiple | 是否允许多节点高亮 | boolean | false | - |
| actived | 高亮节点值(v-model:actived) | Array<TreeNodeValue> | - | - |
| allowDrop | 判断是否可 drop | function | - | - |
| allowFoldNodeOnFilter | 过滤时是否允许折叠 | boolean | false | - |
| checkProps | 透传 Checkbox 属性 | CheckboxProps | - | - |
| checkStrictly | 父子选中不关联 | boolean | false | - |
| checkable | 显示复选框 | boolean | false | - |
| data | 树数据(也可用 props.data) | Array<T> | [] | - |
| disableCheck | 禁用复选框 | boolean | function | false | - |
| disabled | 禁用树操作 | boolean | - | - |
| draggable | 节点可拖拽 | boolean | - | - |
| empty | 数据为空时文本 | string | TNode | '' | - |
| expandAll | 展开全部 | boolean | false | - |
| expandLevel | 默认展开级别 | number | 0 | - |
| expandMutex | 同级展开互斥 | boolean | false | - |
| expandOnClickNode | 点击节点展开收起 | boolean | false | - |
| expandParent | 展开子节点时自动展开父节点 | boolean | false | - |
| expanded | 展开节点值(v-model:expanded) | Array<TreeNodeValue> | [] | - |
| filter | 节点过滤方法 | (node: TreeNodeModel) => boolean | - | - |
| height | 树高度 | string | number | - | - |
| hover | 节点悬浮状态 | boolean | - | - |
| icon | 节点图标 | boolean | TNode<TreeNodeModel> | true | - |
| keys | 字段别名 | TreeKeysType | - | - |
| label | 自定义节点内容 | string | boolean | TNode<TreeNodeModel> | true | - |
| lazy | 延迟加载子节点 | boolean | true | - |
| line | 连接线 | boolean | TNode | false | - |
| load | 加载子数据 | (node) => Promise<Array<T>> | - | - |
| maxHeight | 最大高度 | string | number | - | - |
| operations | 自定义节点操作项 | TNode<TreeNodeModel> | - | - |
| scroll | 懒加载与虚拟滚动 | TScroll | - | - |
| transition | 展开折叠过渡动画 | boolean | true | - |
| value | 选中值 | Array<TreeNodeValue> | [] | - |
| defaultValue | 非受控选中值 | Array<TreeNodeValue> | [] | - |
| valueMode | 选中值模式 | onlyLeaf | parentFirst | all | onlyLeaf | - |
Events
| 事件 | 说明 | 类型 | 版本 |
|---|---|---|---|
| active | 节点激活 | (value, context: { node; e?; trigger }) => void | - |
| change | 选中状态变化 | (value, context: { node; e?; trigger }) => void | - |
| click | 节点点击 | (context: { node; e: MouseEvent }) => void | - |
| dragEnd | 结束拖拽 | (context: { e: DragEvent; node }) => void | - |
| dragLeave | 拖拽离开目标 | (context: { e: DragEvent; node }) => void | - |
| dragOver | 拖拽到目标 | (context: { e: DragEvent; node }) => void | - |
| dragStart | 开始拖拽 | (context: { e: DragEvent; node }) => void | - |
| drop | 在目标上释放 | (context: { e; dragNode; dropNode; dropPosition }) => void | - |
| expand | 展开或收起 | (value, context: { node; e?; trigger }) => void | - |
| load | 异步加载后 | (context: { node }) => void | - |
| scroll | 滚动 | (params: { e: WheelEvent }) => void | - |


