一行代码顶二十行代码! 🔧 修复 React 聊天室滚动加载问题 Bugfix 解决方法分享

前言

之前分享的 React Web IM 聊天室 相关文章链接 有一个滚动加载的 bug,就是向上滚动请求下一页的分页接口。会频繁触发直到拉取完所有数据。

问题排查

首先,看看 Dom 结构。为了实现用户向上滚动等同于向下滚动,我使用了 flex-col-reverse。顶部有一个 加载更多的参考点 ref={loadMoreRef},作为触发下一页请求的标记。每当这根"线"进入视口时,就会触发加载数据。

tsx 复制代码
  <div
    className="no-scrollbar flex flex-1 flex-col-reverse overflow-y-auto p-4"
    style={{ overflowAnchor: 'none' }}
  >
    {/* 用于自动滚动到底部的参考元素 */}
    <div ref={messagesEndRef} />

    {/* 消息列表 */}
    <div className="flex flex-1 flex-col-reverse gap-4">
      {/* 空白占位元素,用于消息少时将消息撑到底部 */}
      <div className="block flex-shrink flex-grow" />

      {/* 聊天记录对话的 DOM 渲染部分 */}
    </div>

    {/* 添加没有更多消息的提示 */}
    {!hasNextPage && messages.length > 0 && (
      <div className="flex justify-center py-2 text-sm text-gray-400">没有更多消息了</div>
    )}

    {/* 加载状态与加载更多参考点 */}
    {isFetchingNextPage ? (
      <div className="flex justify-center py-2">
        <Spin size="small" />
      </div>
    ) : (
      <div ref={loadMoreRef} className="h-1 w-full" />
    )}

    {/* 无消息提示 */}
    {!isLoading && messages.length === 0 && (
      <div className="flex h-full items-center justify-center text-gray-400">暂无聊天记录</div>
    )}
  </div>

问题:每次触发加载请求时,界面会显示 Loading 状态。当请求响应后,加载更多的参考点又会出现在视口中,触发下一页请求。这种循环导致了频繁的接口请求,给用户带来"抖动"的不佳体验。

如何解决

方式一:防抖

我曾尝试通过防抖来延迟请求响应的时间,但这个方式没有完全解决问题。虽然延迟响应能够减少请求频率,但由于 loaderMoreRef 仍然可见,下一次请求仍会被触发,导致问题无法根本解决。

方式二:记录滚动位置

我考虑记录当前滚动到顶部的最后一条消息位置,然后将新数据插入到前面。这种方法能使容器被撑开,loaderMoreRef 被挤上去,直到用户主动滚动到它的位置才会触发下一次请求。经过一番摸索,虽然效果达到了,但代码逻辑变得复杂了许多。

方式三:CSS 技巧(推荐)

我想应该不只有我会遇到这个问题。别人也应该会遇到啊。遂在网上搜了下。react聊天室,列表加载数据滚动条还在顶部?

最后一行代码解决 style={{ overflowAnchor: 'none' }} 一个冷门的 css 属性解决了我的问题。在滚动容器上添加这个属性。这样子就解决了新增数据的时候滚动容器还在最顶部进而导致多次请求的问题了。

MDN overflow-anchor 介绍 作用就是插入新数据时候保留原先的滚动锚点。简单理解就是让浏览器别帮我管理滚动条默认行为。

tsx 复制代码
  <div
    className="no-scrollbar flex flex-1 flex-col-reverse overflow-y-auto p-4"
    style={{ overflowAnchor: 'none' }}
  >

这个方法不仅解决了聊天室中的问题,还有一个相关案例:当图片加载较慢时,尤其是漫画网站,垂直布局的图片会导致页面跳动,重新定位滚动条位置,而 overflow-anchor 同样能解决这个问题。www.zhangxinxu.com/wordpress/2...

结语

所以希望以后做类似功能的小伙伴可以知道这个属性 overflowAnchor: 'none'

相关推荐
成都渲染101云渲染66662 分钟前
如何在3ds Max中实现更快、更高质量的渲染
前端·javascript·人工智能
闲猫2 小时前
Spring AI 对接Deepseek ChatModel 聊天对话
java·前端·spring
自信的未来4 小时前
JSON 工具|Web Worker 工程化打包 + 语法自动修复 + 多语言代码生成实战
java·前端·json
全栈前端老曹4 小时前
【MongoDB】安全与权限管理 —— 用户认证、角色权限、SSL 加密
前端·javascript·数据库·安全·mongodb·nosql·ssl
zhangxingchao5 小时前
AI大模型核心八:从 Agent Skill、长文档 RAG 到知识库更新与训练策略
前端·人工智能·后端
zhangxingchao5 小时前
AI大模型核心七:从 Workflow、RAG、记忆治理到幂等性
前端·人工智能·后端
gyx_这个杀手不太冷静6 小时前
Agent开发进阶指南(第 1 章):AI Agent 到底是什么?
前端·agent·ai编程
小小小小宇6 小时前
模型相关知识
前端
小小小小宇7 小时前
模型相关知识二
前端
IT_陈寒7 小时前
Python装饰器竟然偷偷改了函数名?这个坑我爬了三天
前端·人工智能·后端