监控中心的大屏经常被要求「自动翻页」:值班室墙上挂着的大屏,第一页看产线、隔十秒翻到第二页看能耗、再翻到第三页看告警——不需要有人碰鼠标,一块屏把几个业务口轮着播。
实现层面这就是个定时器加个翻页函数,两行代码的事。但把渲染内核(datavisRender)的多子屏轮播链路拆开看,真正花心思的地方在翻页之外:子屏怎么组织、切换时哪些东西要重建、哪些东西千万不能漏清。这篇按真实链路拆。
一、子屏的数据结构:三层架构里的一层
大屏图纸 JSON 是三层结构:backend(背景层,一块屏共用一个)、screen(子屏列表,数组)、frontend(前景层,全局一个)。子屏就住在中间那层数组里:
{
"config": {
"width": 1920, "height": 1080,
"renderMode": "fit",
"defaultScreenId": "screen_001",
"toolbar": { "enable": true, "playEnabled": false, "playInterval": 5 }
},
"backend": [{ "objects": [] }],
"screen": [
{ "uid": "screen_001", "objects": [] },
{ "uid": "screen_002", "objects": [] }
],
"frontend": [{ "objects": [] }]
}
每个子屏是独立的 uid + 对象数组,互不嵌套。轮播配置也在 config 里:toolbar.playEnabled 是总开关,playInterval 是轮播间隔秒数,defaultScreenId 指定首屏(不是数组第一个,允许运营把最常用的业务口放首位)。
这个结构决定了轮播的本质:翻页 = 换掉 screen 层,背景和前景不动。这也是「轮播是整个子屏切换,不是组件级动画」这句话的数据基础。
二、轮播链路:四个函数各管一段
渲染启动时,handleSetScreenData 解析图纸拿到 screenList;随后轮播的驱动链路是:
handleSetScreenData(data) # 解析出 screenList 子屏列表
→ 读取 config.toolbar.playEnabled / playInterval
→ handleAutoPlay()
→ setInterval(每 playInterval * 1000 毫秒)
→ handleChangeBoard(playIndex++) # 到点翻页
→ 切换 state.screenData
→ 合并 背景+当前子屏+前景 → editor.objects
→ 触发 page 事件(通知业务方当前页码)
→ setSignalData 派发信号数据
→ 延迟 100ms 调用 onPageMounted
→ handleCancelPlay() # 任何切换前清掉旧定时器
四个关键点展开。
翻页即重挂载。 handleChangeBoard 把「背景 + 当前子屏 + 前景」三层合并成一份 editor.objects 交给引擎——注意这是整列表替换,不是在新画布上叠加。切走的那一屏对象全部从 objects[] 移除,切进来的这一屏重新实例化。这是轮播最容易被低估的成本:子屏切换会重新触发数据请求与页面挂载事件,子屏里的每个接口组件都要重新拉一次数据。子屏越多、组件越重,翻页瞬间的负载越明显。
page 事件与信号数据。 每次翻页触发 page 事件、调 setSignalData 派发信号数据、延迟 100ms 调 onPageMounted。这 100ms 的延迟不是随意的——给页面挂载留出 DOM 就位的窗口,业务方在 onPageMounted 里做的二次处理(比如基于面板位置的联动)才有可靠前提。
手动与自动共存。 工具栏的下拉可以手动切换子屏,暂停/播放按钮控制轮播。手动切换走的是同一个 handleChangeBoard,区别只是触发源——这保证手动和自动翻页的合并逻辑、事件派发完全一致,不会出现「自动翻页正常、手动翻页少触发事件」的分裂。
切换前必须清旧定时器。 handleCancelPlay 在切换时清除旧定时器,避免重复——如果不清,两次配置叠加会导致翻页间隔错乱(实际间隔变成两个定时器的叠加效应)。
三、清理时机:轮播功能最容易死在「没清干净」
§5.2 风险提示 里躺着两类真实风险,都是「切换时没清干净」的变体:
- 定时器泄漏:
useApiRequest的editor.__apiRequestIntervalTimer(组件级接口定时拉取)与轮播的state.playInstance都需在卸载时清理。内核已见onBeforeUnmount处理,但子屏切换时的清理需重点验证——翻页移除了旧子屏的组件,那些组件自己的拉取定时器清了吗? - WebSocket 连接泄漏:
useApiWebsocket把实例挂在editor.__websocketInstance,若子屏频繁切换未正确关闭,可能产生多个连接。 WebSocket 比定时器更隐蔽:连接对象不触发 CPU 占用告警,静静吃着服务端连接数,直到某天网关把连接打满。
轮播场景把这两类风险放大了——每 playInterval 秒就来一轮「创建 + 销毁」,十秒一翻的大屏跑一天,就是八千多次组件生命周期。任何一次清理疏漏,泄漏速度都是普通页面的几百倍。所以内核的处理原则是:切换时 handleCancelPlay 清轮播定时器、组件卸载走 onBeforeUnmount 清自己的资源,两层清理各自负责、互不依赖。依赖任何一层的「顺手清理」,都会在某一处边界条件下漏掉。
四、一块真实运行的大屏
看一张 AI 生成引擎产出的污水处理厂监控大屏——左侧指标总览与达标趋势、中部工艺流程图、底部设备告警流水。这类单屏是轮播的「一页」:实际投放时,产线一页、能耗一页、告警一页,每页都是这样一份完整的三层结构文档:
再配一张同模板体系的水利水电大屏——不同行业的子屏共享同一份背景层,轮播切换时只有中间
screen 层在换:
五、小结
多子屏轮播的实现要点收敛为四条:子屏独立成层(screen 数组 + uid)、翻页即整屏重挂载(合并三层替换 objects、重新触发数据请求)、手动自动同一链路(handleChangeBoard 是唯一入口)、两层清理各自负责(handleCancelPlay 管轮播定时器,组件 onBeforeUnmount 管自己的资源)。
把「一个 setInterval」写成一套可靠的轮播,差的不是代码量,是对「切换时什么该重建、什么必须清掉」的完整清单。
注:文中面板数值为演示数据,非客户数据。
体验地址:www.qiantech.com.cn/