一行代码顶二十行代码! 🔧 修复 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'

相关推荐
ew4521818 分钟前
【VUE】某时间某空间占用情况效果展示,vue2+element ui实现。场景:会议室占用、教室占用等。
前端·vue.js·ui·elementui
唐人街都是苦瓜脸24 分钟前
Vue 3中unref的写法
前端·javascript·vue.js
猫老板的豆41 分钟前
react-activation 组件级缓存解决方案
javascript·react.js·缓存
前端小菜鸟吖1 小时前
2025年最新版HTML5超完整教程
前端·html
中微子1 小时前
WeUI-Uploader 源码深度解析:大厂必考的上传组件实现
前端
我想说一句1 小时前
在Colab玩转大模型:一天速成NLP魔法师!
前端·nlp·trae
NicoNico1 小时前
Wordle:为逗女友而爆火的小游戏
前端·html
嘉小华1 小时前
深入浅出 动态代理
前端
heartmoonq1 小时前
前端工程化实践:从多页面构建到分包优化的思考
前端
我是谁谁1 小时前
在 UniApp 开发中,由于需要跨平台(小程序、H5、App 等),样式兼容性是常见挑战
前端·面试