如何实现无整页刷新更新Golang后端渲染的zTree节点图标
问题根因说明
原有刷新方案的问题
- 使用
<meta http-equiv="refresh">触发的整页加载会重置所有DOM状态,必然出现闪烁、输入框焦点丢失、树展开层级/选中状态被重置的问题,不符合无刷新更新的要求。
Vue绑定zTree失效的原因
- Vue的
{{ customIcon }}模板语法仅能作用于Vue直接渲染的HTML节点,无法在纯JS数组中被解析,会直接导致JS语法报错。 - zTree是基于jQuery开发的第三方插件,其生成的DOM结构完全不受Vue响应式系统管控,仅修改Vue中的数据字段不会自动触发zTree的视图更新。
可行实现方案
两种方案均通过zTree自带API做局部更新,不触发整页刷新,完全避免闪烁、状态丢失的问题。
方案一:轻量Ajax轮询(无需引入Vue,改动最小)
完全基于zTree原生能力实现,兼容原有代码逻辑,不会破坏页面现有交互状态。
实现步骤:
- 删除页面头部的
<meta http-equiv="refresh" content="5">整页刷新标签 - 初始化zTree时保留全局实例引用
- 定时向后端拉取需要更新图标的节点列表,通过zTree内置API定位节点、修改icon属性、局部刷新对应节点
核心实现代码示例:
// 全局存储zTree实例 let zTreeObj; const setting = { data: { simpleData: { enable: true, idKey: "id", pIdKey: "pId", rootPId: "" } } }; const zNodes = [ {id: 1, pId: 0, name: "root", icon:"../static/css/zTreeStyle/img/diy/c16green.png"}, {id: 2, pId: 1, name: "leaf", icon:"../static/css/zTreeStyle/img/diy/c16red.png"}, ]; $(document).ready(function () { // 初始化zTree并存下实例 zTreeObj = $.fn.zTree.init($("#tree"), setting, zNodes); // 每5秒轮询后端拉取最新节点图标 setInterval(() => { // 请求后端接口,返回格式示例:[{id: 2, icon: "新的图标路径"}] $.get('/api/tree/latest-icons', (updatedNodes) => { if (!Array.isArray(updatedNodes)) return; // 遍历需要更新的节点 updatedNodes.forEach(nodeInfo => { // 按id找到zTree中的对应节点 const targetNode = zTreeObj.getNodeByParam("id", nodeInfo.id); // 仅在图标实际变化时执行更新,减少不必要的DOM操作 if (targetNode && targetNode.icon !== nodeInfo.icon) { targetNode.icon = nodeInfo.icon; // 仅刷新当前节点,不重绘整棵树 zTreeObj.updateNode(targetNode); } }) }) }, 5000) });
该操作仅修改目标节点的DOM属性,页面其他区域的交互状态、输入焦点、滚动位置都不会受到影响。
方案二:正确结合Vue与zTree(解决绑定失效问题)
如果已经引入Vue,需要调整交互逻辑适配zTree的DOM管理机制:
- 把zTree节点数据存入Vue的响应式字段,初始化zTree时直接读取该字段,不要在JS代码中写Vue模板语法
- 当Vue中的节点图标数据变化时,手动调用zTree的API完成视图更新,不依赖Vue的自动DOM渲染
修正后的核心代码示例:
<div id="app"> <!-- 原有页面结构 --> <ul id="tree" class="ztree"></ul> <p>当前时间:{{ now }}</p> </div>
const app = new Vue({ el: '#app', data: { now: new Date(), zTreeInstance: null, // zTree节点数据直接存为Vue响应式字段 zNodes: [ {id: 1, pId: 0, name: "root", icon:"../static/css/zTreeStyle/img/diy/c16green.png"}, {id: 2, pId: 1, name: "leaf", icon:"../static/css/zTreeStyle/img/diy/c16red.png"}, {id: 3, pId: 1, name: "foo", icon:"../static/css/zTreeStyle/img/diy/c16green.png"}, ] }, mounted() { // 等待DOM渲染完成后初始化zTree this.$nextTick(() => { this.zTreeInstance = $.fn.zTree.init($("#tree"), { data: { simpleData: { enable: true, idKey: "id", pIdKey: "pId", rootPId: "" } } }, this.zNodes); }) // 定时更新逻辑 setInterval(() => { this.updateDate(); // 模拟从后端拉取到的节点图标更新 const newIcon = Math.random() > 0.5 ? "../static/css/zTreeStyle/img/diy/c16green.png" : "../static/css/zTreeStyle/img/diy/c16red.png"; // 更新Vue中的响应式数据 const targetNode = this.zNodes.find(n => n.id === 3); if (targetNode) { targetNode.icon = newIcon; } // 手动触发zTree视图更新(必须步骤) const zTreeNode = this.zTreeInstance.getNodeByParam("id", 3); if (zTreeNode) { zTreeNode.icon = newIcon; this.zTreeInstance.updateNode(zTreeNode); } }, 5000) }, methods: { updateDate() { this.now = new Date(); } } })
注意事项
- 如果项目没有复杂的双向绑定需求,优先选择方案一,减少Vue引入带来的额外开销
- 轮询的时间间隔可以根据实际业务调整,不需要严格固定为5秒
- 如果后续需要更新节点名称、层级结构,也可以复用同样的局部更新方法,不需要整树重绘
内容的提问来源于stack exchange,提问作者d2s1
相关产品推荐
相关产品推荐

