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

相关推荐
OctShop大型商城源码7 天前
商城小程序开源商用_OctShop免费开源可商用的商城小程序
小程序·开源·小程序商城·免费开源可商用的商城小程序
CRMEB定制开发13 天前
利用 PowerShell 脚本实现 UniApp H5 项目自动化打包压缩部署
小程序商城·公众号商城·商城源码·crmeb·开源商城
CRMEB21 天前
高品质开源电商系统的技术内核:架构设计与技术优势
ai·开源·php·免费源码·源代码管理·商城源码
CRMEB定制开发22 天前
如何在 VSCode 中配置 PHP 开发环境
vscode·商城系统·小程序商城·商城源码·微信商城·crmeb
徐礼昭|商派软件市场负责人1 个月前
ECShopX商城系统与ONEX OMS订单管理系统,正式开源发布
开源·开源软件·开源商城·开源oms
CRMEB定制开发1 个月前
CRMEB-PHP商品分类系统开发指南:多级分类、批量管理与SEO优化
商城系统·小程序商城·商城源码·微信商城·crmeb
微三云、小叶2 个月前
HashKey上市:不是炒币,是RWA的合规起点
软件开发·商业模式·小程序商城·商业思维
CRMEB定制开发2 个月前
CRMEB-PHP商品迁移模块解析:跨店铺迁移与数据导入导出实现
商城系统·小程序商城·公众号商城·微信商城·crmeb
CRMEB定制开发2 个月前
CRMEB-PHP商品采集模块开发指南:API对接与批量上架实现
小程序商城·公众号商城·商城源码·crmeb·开源商城