Tree 树形控件
WebH5
树形控件。展示层级数据,支持展开/收起、单选高亮、级联勾选(父级勾选/取消所有子孙,子级部分勾选时父级半选)。
何时使用
展示和操作的层级数据:目录、组织架构、多级分类。
何时不使用
只是让用户选一条层级路径时,用 Cascader 更省空间。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
nodes | Array<TreeNode> | [] | 树数据,项为 { label: string; value: string | number; children?: 同构; disabled?: boolean } |
expandAll | boolean | false | 默认展开全部有子节点的节点 |
checkable | boolean | false | 是否显示复选框;勾选父级级联勾选/取消所有子孙,子级部分勾选时父级显示半选 |
checkedKeys | Array<string | number> | [] | 勾选的 key 列表,配合 v-model:checkedKeys 使用 |
selectedKey | string | number | null | null | 单选高亮的 key,配合 v-model:selectedKey 使用;点击节点即更新 |
expandedKeys | Array<string | number> | "undefined(内部维护展开态)" | 展开的 key 列表,配合 v-model:expandedKeys 受控使用;不传时由组件内部维护 |
indent | number | 16 | 每层缩进(px) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:checkedKeys | Array<string | number> | 勾选变化时触发,用于 v-model:checkedKeys |
update:selectedKey | string | number | null | 点击节点时触发,用于 v-model:selectedKey |
update:expandedKeys | Array<string | number> | 展开/收起节点时触发,用于 v-model:expandedKeys |
node-click | TreeNode | 点击节点时触发;disabled 节点不触发 |
示例
部门树(单选高亮)
示例加载中…
权限配置(级联勾选)
示例加载中…
默认全部展开
示例加载中…
自定义缩进
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Tree 文档(含手机预览)。