Web 实现多组件同步滚动

前言

在日常业务开发中,我们有时会遇到多个组件需要同步滚动的场景;例如在某个页面中存在多个相关的数据表格,用户在滚动其中一个表格时,其他表格也同步滚动保证数据行的对齐;这个功能在数据看板、仪表盘等多种场景下都很常见。

实现这种功能并非难事,主要思路为监听各个组件的滚动事件,当某个组件主动滚动后将自身的滚动状态同步给其他组件;但这种实现方式背后存在严重的隐患:当某个组件接收到来自其他组件的主动滚动信息,并据此对自身的滚动状态加以同步后,该组件会被动触发滚动事件,并将自身的滚动信息传递给主动滚动组件;在这种情况下,极易造成死循环,并在页面上的表现为组件不停"抽搐"。

思路

要解决这个问题,我们需要理清思路;我们假设当前存在 A 和 B 两个可滚动组件需要进行信息同步,按照上述解决方案编写代码后,整个事件的触发流程如下:

复制代码
A 主动滚动 -> B 同步 A 的滚动信息 -> A 同步 B 的滚动信息 -> A 主动滚动 -> 无限循环

而理想状态下整个事件的触发流程如下:

复制代码
A 主动滚动 -> B 同步 A 的滚动信息 -> A 主动滚动 -> B 同步 A 的滚动信息

两者中的区别在于,理想状态下被动滚动的组件不会反复触发滚动事件造成主动组件的滚动。要解决这个问题,我们可以通过在滚动事件中对引起滚动的来源进行区分,从而判断是否要进行滚动信息同步。

Coding

首先编写组件对应的滚动处理程序,当某个组件主动滚动时,scrollPart 为空,则将 scrollPart 设置为当前组件名称;而主动滚动的组件再次触发滚动时,将会同步滚动信息给其他组件,此时其他组件会被动触发滚动事件;由于此前已将 scrollPart 设置为主动滚动事件的组件名称,因此其他组件被动触发滚动事件后会将 scrollPart 置空。

在这种情况下,即使主动滚动的组件被其他组件触发被动滚动,也不会再次进行同步。

复制代码
type ScrollPart = "compA" | "compB";
let scrollPart: ScrollPart; // 触发原始滚动的组件名称

// 根据组件名称生成组件滚动事件的回调处理程序
const scrollCallbackFactory = (key: ScrollPart) => {
    return () => {
        if (!scrollPart) {
            scrollPart = key;
        } else if (scrollPart === key) {
            syncScrollState();
        } else {
            scrollPart = undefined;
        }
    }
}

接下来需要添加事件监听程序和事件信息同步程序。

复制代码
const compA = document.querySelector("#compA");
const compB = document.querySelector("#compB");

compA.addEventListener("scroll", scrollCallbackFactory("compA"));
compA.addEventListener("scroll", scrollCallbackFactory("compB"));

function syncScrollState() {
    switch (scrollPart) {
        case "compA":
            compB.scrollTop = compA.scrollTop;
            break;
        case "compB":
            compA.scrollTop = compB.scrollTop;
            break;
    }
}

这种处理组件同步的方法是可扩展的,支持横向、纵向滚动以及多个组件滚动,只需给对应组件添加事件监听,并在 syncScrollState 函数里按照对应的组件同步滚动信息即可。

附件:https://gitee.com/ZhongBangKeJi/CRMEB

相关推荐
kepppt2 天前
2026年国内开源商城生态报告——从“商城源码大战”到“商业数字化平台竞争”,中国开源商城市场正在发生什么?
开源·开源商城
微三云、小叶4 天前
基于存量消费重构的物业商业化系统:本地零售 + 线上电商 + CPS 返利业务架构拆解
软件开发·商业模式·小程序商城·本地生活·商业思维
微三云、小叶6 天前
邀请退款升级模型的系统架构与权益分配机制
软件开发·商业模式·小程序商城·本地生活·商业思维
微三云、小叶6 天前
全域消费一卡通系统设计:卡券分层、分账机制与多级推广体系架构
软件开发·商业模式·小程序商城·本地生活·商业思维
kepppt7 天前
2026年开源商城系统选型指南:LikeShop、CRMEB、ShopXO、TigShop 如何选择?
开源商城
kepppt10 天前
2026年开源商城系统推荐:哪种商城更适合长期二次开发?——真正决定商城系统长期价值的,从来不是“前期功能多少”,而是“后期还能不能持续扩展”
开源商城·likeshop
微三云、小叶11 天前
一卡通 “金券 + 银券” 模式拆解:一套可复用的私域用户活跃运营机制
软件开发·商业模式·小程序商城·本地生活·商业思维
微三云、小叶12 天前
三三复制公排算法与广告积分流转模型:项目落地的三个技术关键点
软件开发·商业模式·小程序商城·本地生活·商业思维
OctShop大型商城源码12 天前
OctShop对比JAVA商城源码_OctShop大型专业级多用户商城源码
java·开发语言·商城系统·小程序商城·octshop
kepppt12 天前
哪个开源商城系统更适合二次开发?2026年很多企业开始重视“长期维护成本”——很多系统前期开发很快,但真正决定企业未来成本的,其实是“后期还能不能继续改”
开源商城·likeshop