大屏多子屏轮播怎么实现:定时器与清理时机

9 阅读5分钟

大屏多子屏轮播 监控中心的大屏经常被要求「自动翻页」:值班室墙上挂着的大屏,第一页看产线、隔十秒翻到第二页看能耗、再翻到第三页看告警——不需要有人碰鼠标,一块屏把几个业务口轮着播。

实现层面这就是个定时器加个翻页函数,两行代码的事。但把渲染内核(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 生成引擎产出的污水处理厂监控大屏——左侧指标总览与达标趋势、中部工艺流程图、底部设备告警流水。这类单屏是轮播的「一页」:实际投放时,产线一页、能耗一页、告警一页,每页都是这样一份完整的三层结构文档:

AI 生成的污水处理厂监控大屏:轮播中的「一页」 再配一张同模板体系的水利水电大屏——不同行业的子屏共享同一份背景层,轮播切换时只有中间 screen 层在换:

水利水电大屏:与污水厂屏共享背景层的另一「页」

五、小结

多子屏轮播的实现要点收敛为四条:子屏独立成层(screen 数组 + uid)、翻页即整屏重挂载(合并三层替换 objects、重新触发数据请求)、手动自动同一链路(handleChangeBoard 是唯一入口)、两层清理各自负责(handleCancelPlay 管轮播定时器,组件 onBeforeUnmount 管自己的资源)。

把「一个 setInterval」写成一套可靠的轮播,差的不是代码量,是对「切换时什么该重建、什么必须清掉」的完整清单。

注:文中面板数值为演示数据,非客户数据。


体验地址:www.qiantech.com.cn/