讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

如何在 React 中实现移动端与桌面端通用的无限滚动列表

阿晨姑娘_2621

阿晨姑娘_2621

发布时间:2025-12-27 19:43:02

|

543人浏览过

|

来源于php中文网

原创

如何在 React 中实现移动端与桌面端通用的无限滚动列表

本文详解如何使用 react-infinite-scroll-component 在 react/typescript 项目中实现响应式无限滚动,支持首次加载 10 条动态、触底自动加载下一批 10 条,并兼顾移动端和桌面端滚动容器兼容性。

在现代社交类或内容聚合型应用中,无限滚动(Infinite Scroll)是提升用户体验的关键交互模式。相比传统分页,它能减少用户操作、避免页面跳转,并自然适配移动端浏览习惯。本文将基于你已有的 MainSection 组件,完整集成 react-infinite-scroll-component,实现首次渲染 10 条帖子 → 滚动至末尾时加载下 10 条 → 支持桌面端(窗口滚动)与移动端(容器内滚动)双模式。

✅ 前置准备:安装依赖

npm install react-infinite-scroll-component
# 或
yarn add react-infinite-scroll-component

✅ 步骤一:改造状态管理与数据切片逻辑

首先,在 MainSection 中引入必要 Hook 和状态,并分离「原始数据」与「当前展示数据」:

import { useState, useEffect, useRef } from 'react';
import InfiniteScroll from 'react-infinite-scroll-component';
import PostStyles from '../../../components/ui/createPost/_createpost.module.scss';
import CreatePost from '../createPost/createPost';
import Post from '../post/post';
import Modal from '../createPost/Modal';
import { postType } from '../../../util/types';

type mainSectionType = {
  posts: postType[]; // 原始全量数据(可来自 props 或服务端分页 API)
};

const MainSection = ({ posts }: mainSectionType) => {
  const [slicedData, setSlicedData] = useState<postType[]>([]);
  const [hasMore, setHasMore] = useState(true);
  const [startIndex, setStartIndex] = useState(0);
  const itemsPerPage = 10;
  const scrollableDivRef = useRef<HTMLDivElement>(null);

  // 初始加载第一页(前 10 条)
  useEffect(() => {
    setSlicedData(posts.slice(0, itemsPerPage));
    setHasMore(posts.length > itemsPerPage);
    setStartIndex(itemsPerPage);
  }, [posts]);

  // 加载下一批数据
  const loadMorePosts = () => {
    if (startIndex >= posts.length) return;

    const nextBatch = posts.slice(startIndex, startIndex + itemsPerPage);
    setSlicedData(prev => [...prev, ...nextBatch]);
    const newStartIndex = startIndex + itemsPerPage;

    setStartIndex(newStartIndex);
    setHasMore(newStartIndex < posts.length);
  };

  return (
    <>
      <Modal />
      <div className={PostStyles.post__create_postContainer}>
        <CreatePost />
      </div>
      {/* 关键:为无限滚动提供明确的滚动容器 */}
      <div 
        ref={scrollableDivRef} 
        id="scrollableDiv" 
        className={PostStyles.post__posts_container}
        style={{ overflowY: 'auto', height: 'calc(100vh - 200px)' }} // 响应式高度建议
      >
        <InfiniteScroll
          dataLength={slicedData.length}
          next={loadMorePosts}
          hasMore={hasMore}
          loader={
            <div className="text-center py-4">
              <p>Loading more posts...</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/xiazai/skill11824" title="shopify-app-react-router"><img
                                                                                src="https://img.php.cn/upload/skill/001/246/273/6adaf20dee630206.jpg" alt="shopify-app-react-router" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/xiazai/skill11824" title="shopify-app-react-router">shopify-app-react-router</a>
                                                                        <p>构建 Shopify 嵌入式应用(Embedded App)的开发技能:基于 @shopify/shopify-app-react-router + React Router v7 + Admin API 2026-04。覆盖 shopifyApp 配置、authenticate.admin 的 GraphQL/REST 调用、Webhook 校验、Session 存储、订阅计费、App Bridge 导航、部署,并新增:适用场景判断、安全最佳实践、错误处理与容错、最佳实践、常见问题 FAQ、高级场景。G</p>
                                                                </div>
                                                                <a href="/xiazai/skill11824" title="shopify-app-react-router" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div>
            </div>
          }
          endMessage={
            <p className="text-center py-4 text-gray-500">
              ? You've reached the end!
            </p>
          }
          // ✅ 移动端 & 桌面端兼容关键配置:
          scrollableTarget="scrollableDiv" // 指定容器 ID(必须唯一且存在)
          // 如果希望监听 window 滚动(如整个页面滚动),则移除 scrollableTarget 并确保父容器不设 overflow
        >
          {slicedData.map((post, index) => (
            <Post
              key={post._id} // ⚠️ 强烈建议用唯一 ID 而非 index
              post_desc={post.post_description}
              postID={post._id}
              username={post.creator.name}
              timeposted={post.time_posted}
              userImg={post.creator.profilePicture}
              photos={post.photos}
            />
          ))}
        </InfiniteScroll>
      </div>
    </>
  );
};

export default MainSection;

✅ 步骤二:CSS 适配(确保滚动容器生效)

在你的 SCSS 文件(如 _createpost.module.scss)中,为 .post__posts_container 添加以下样式以支持跨平台滚动:

.post__posts_container {
  // 必须显式设置高度 + overflow,否则 InfiniteScroll 无法检测滚动事件
  max-height: calc(100vh - 200px); // 根据顶部导航/创建区高度动态调整
  overflow-y: auto;

  // 移动端优化:启用平滑滚动 & 防止橡皮筋效果
  -webkit-overflow-scrolling: touch;
  scrollbar-width: thin;
  scrollbar-color: #888 #f1f1f1;

  &::-webkit-scrollbar {
    width: 6px;
  }
  &::-webkit-scrollbar-track {
    background: #f1f1f1;
  }
  &::-webkit-scrollbar-thumb {
    background: #888;
    border-radius: 3px;
  }
}

⚠️ 注意事项与最佳实践

  • Key 值必须唯一:将 key={index} 替换为 key={post._id},避免列表重排时 React Diff 失效。
  • 滚动目标选择:
    • scrollableTarget="scrollableDiv" → 适用于容器内滚动(推荐移动端及固定高度 Feed 区);
    • 若需监听整个窗口滚动(如首页全屏滚动),请移除 scrollableTarget 属性,并确保 .post__posts_container 不设 overflow,让滚动发生在 window 上。
  • 服务端分页扩展:当前示例基于客户端全量数据切片。生产环境建议改为 useEffect + fetchNextPage() 调用后端分页接口(如 /api/posts?page=2&limit=10),并配合 loading 状态防重复触发。
  • 性能优化:长列表建议结合 React.memo 包裹 Post 组件,或使用 react-window 实现虚拟滚动(当单页超 100+ 条时)。

通过以上实现,你的动态列表即可在手机浏览器、iPad 及桌面 Chrome/Firefox 中稳定触发无限加载,无需额外判断设备类型 —— react-infinite-scroll-component 内部已做跨平台滚动事件兼容处理。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

332

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

540

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

411

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

326

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

738

2026.06.16

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2946

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6079

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

4347

2026.03.24

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn