vue-giant-tree

? 巨树:基于ztree封装的Vue树形组件,轻松实现海量数据的高性能渲染。

logo

为什么需要vue-giant-tree

Vue的数据监听机制决定了在大数据量场景下的渲染性能非常低下,基于Vue实现的常规树组件几乎无法胜任上万条数据的高性能渲染,在IE浏览器(即便是IE11)中很容易导致页面卡死甚至浏览器崩溃。

不服气可以试试这份数据 big-tree.json

为了摆脱数据监听,只能放弃通过Vue渲染,采用常规DOM操作的方式。在这个领域ztree是当之无愧最成熟的方案,因此vue-giant-tree直接基于ztree做上层封装,以组件的形式将ztree的配置和事件暴露出来,使其可以方便的在Vue项目中安装使用。

vue-giant-tree仅仅是给ztree套了一层Vue组件的壳,顺便提供了一套更现代化的皮肤,因为主打大数据量场景,所以取名巨树

ztree在性能优化方面已经做到了近乎极致,感谢ztree作者的工作,向您致敬!

安装

npm i vue-giant-tree --save

使用

in script:

import tree from "vue-giant-tree";

export default {
	components: {
          tree
	},
	data() {
		return {
			nodes: [
                    { id:1, pid:0, name:"随意勾选 1", open:true},
                    { id:11, pid:1, name:"随意勾选 1-1", open:true},
                    { id:111, pid:11, name:"随意勾选 1-1-1"},
                    { id:112, pid:11, name:"随意勾选 1-1-2"},
                    { id:12, pid:1, name:"随意勾选 1-2", open:true},
                    { id:121, pid:12, name:"随意勾选 1-2-1"},
                    { id:122, pid:12, name:"随意勾选 1-2-2"},
                    { id:2, pid:0, name:"随意勾选 2", checked:true, open:true},
                    { id:21, pid:2, name:"随意勾选 2-1"},
                    { id:22, pid:2, name:"随意勾选 2-2", open:true},
                    { id:221, pid:22, name:"随意勾选 2-2-1", checked:true},
                    { id:222, pid:22, name:"随意勾选 2-2-2"},
                    { id:23, pid:2, name:"随意勾选 2-3"}
                ]
		}
	}
	...

in template:

<tree :nodes="nodes" />

属性

参数说明类型默认值
settingztree 配置Object{view: {showIcon: false}}
nodesztree 数据Array[]

事件

完全移植zTree APIcallback支持的事件,除了:

  • 不支持所有 before 开头的事件。这类事件的主要作用是根据返回值决定是否阻止后续的on事件,这种判断可以在on事件中实现;当然,你也可以通过setting.callback.beforeXXX自行配置
  • 不支持 onNodeCreated 事件。因为在大数据量下很耗性能,如果需要可以通过 setting.callback.onNodeCreated 自行传入
  • 增加 onCreated 事件。每此实例初始化完成时触发,回调参数接收ztree实例,通过ztree实例可以使用所有实例方法
参数说明
onAsyncError参考 zTree API
onAsyncSuccess参考 zTree API
onCheck参考 zTree API
onClick参考 zTree API
onCollapse参考 zTree API
onDblClick参考 zTree API
onDrag参考 zTree API
onDragMove参考 zTree API
onDrop参考 zTree API
onExpand参考 zTree API
onMouseDown参考 zTree API
onMouseUp参考 zTree API
onRemove参考 zTree API
onRename参考 zTree API
onRightClick参考 zTree API
onCreated初始化渲染完成后触发,回调参数接收ztree实例

扩展

zTree没有提供给整个实例更新数据的方法,vue-giant-tree基于Vue的组件通信机制扩展实现了响应式数据,只要nodes属性的值发生变化,ztree实例就会随之更新。

项目DEMO里演示了vue-giant-tree的响应式数据特性。

演示

  • 线上演示:

http://refined-x.com/Vue-Giant-Tree/

  • 本地演示:
npm i 
npm run serve 

License

MIT

Logo

前往低代码交流专区

更多推荐