Three.js + React 实战系列 - 项目展示区开发详解 Projects 组件(3D 模型 + 动效 + 状态切换)✨

对个人主页设计和实现感兴趣的朋友可以订阅我的专栏哦!!谢谢大家!!!

在这一篇博客中,我们将搭建项目主页中极具互动性的 Projects 区域。

该组件承担着展示个人项目展示的功能,融合 GSAP 动画、@react-three/fiber 3D 展示与交互式切换等高级特性,用户体验上极具冲击力。

React + ThreeJS 个人主页小项目:🎥 05 · 项目展示区开发详解 Projects 组件(3D 模型 + 动效 + 状态切换)

✨ 组件亮点概览

  • 结合 GSAP 实现文字动画过渡效果;
  • 通过 <Canvas> 实现 3D 电脑模型展示;
  • 支持左右翻页浏览多个项目;
  • 响应式设计与美观的卡片式信息布局。

📁 项目结构建议

组件路径:

复制代码
src/
├--- components/
│   └--- DemoComputer.jsx
├--- sections/
│   └--- Projects.jsx
└--- constants/
    ├--- index.js

🔄 状态切换逻辑

我们定义了 selectedProjectIndex 来记录当前浏览的项目,通过 handleNavigation 来控制前后切换逻辑,形成一个循环浏览:

js 复制代码
const handleNavigation = (direction) => {
  setSelectedProjectIndex((prevIndex) => {
    if (direction === 'previous') {
      return prevIndex === 0 ? projectCount - 1 : prevIndex - 1;
    } else {
      return prevIndex === projectCount - 1 ? 0 : prevIndex + 1;
    }
  });
};

🌟 动画效果(GSAP)

通过 useGSAP,我们对每次切换项目时的 .animatedText 类名文字应用淡入动画,增强用户体验:

js 复制代码
useGSAP(() => {
  gsap.fromTo('.animatedText', { opacity: 0 }, {
    opacity: 1,
    duration: 1,
    stagger: 0.2,
    ease: 'power2.inOut'
  });
}, [selectedProjectIndex]);

fromTo 方法:初始状态将文字透明度设为 0,然后在 1 秒内逐个淡入(通过 stagger 实现),动画曲线为 power2.inOut,使文字的出现显得柔和流畅,极大提升了用户在浏览项目时的沉浸感和专业感。


🖼️ 左侧:项目信息面板

包括:项目封面图、logo、标题描述、标签、跳转链接,以及左右切换按钮。

js 复制代码
<img src={currentProject.spotlight} alt="spotlight" className="..." />
<p className="text-white text-2xl font-semibold animatedText">{currentProject.title}</p>

所有数据来源于 myProjects 常量数组,并支持动态渲染每个项目对应的内容。


🖥️ 右侧:3D 电脑展示区域

采用 @react-three/fiber<Canvas> 实现沉浸式项目封面展示。

html 复制代码
<Canvas>
  <ambientLight intensity={Math.PI} />
  <directionalLight position={[10, 10, 5]} />
  <Center>
    <Suspense fallback={<CanvasLoader />}>
      <group scale={2} position={[0, -3, 0]} rotation={[0, -0.1, 0]}>
        <DemoComputer texture={currentProject.texture} />
      </group>
    </Suspense>
  </Center>
  <OrbitControls maxPolarAngle={Math.PI / 2} enableZoom={false} />
</Canvas>

其中 DemoComputer 是一个自定义 3D 模型组件,配合不同 texture 显示不同项目封面。


📌 总结

Projects.jsx 组件是整个主页中前后端交互最强、技术栈最丰富的板块之一,建议优先理清以下要点:

  • 熟练使用 state 管理当前展示内容;
  • 理解如何配合 GSAP 动画提升 UX;
  • 熟悉 Fiber Canvas 与 Drei 工具的用法;
  • 数据抽象与复用能力的提升。

🔠 下一篇预告:客户评价区域

我们将在下一节中:

  • 🌟 构建客户评价区域(Client)
  • ✨ 使用 gsap 为内容添加滑入动效
  • ⛳️ 信息条目数据化驱动,方便扩展

对个人主页设计和实现感兴趣的朋友可以订阅我的专栏哦!!谢谢大家!!!

我们下一节见!👋

相关推荐
GISBox1 分钟前
GISBox实操指南:如何将IFC文件高效转换为3DTiles格式‌‌
3d·免费工具
海底火旺3 分钟前
单页应用路由:从 Hash 到懒加载
前端·react.js·性能优化
Heo4 分钟前
调用通义千问大模型实现流式对话
前端·javascript·后端
Listennnn7 分钟前
3D Semantic Occupancy Prediction
3d
三月的一天16 分钟前
react+threejs实现自适应分屏查看/3D场景对比功能/双场景对比查看器
3d·分屏控制·react threejs·多场景渲染
前端小巷子1 小时前
深入 npm 模块安装机制
前端·javascript·面试
深职第一突破口喜羊羊2 小时前
记一次electron开发插件市场遇到的问题
javascript·electron
cypking2 小时前
electron中IPC 渲染进程与主进程通信方法解析
前端·javascript·electron
西陵2 小时前
Nx带来极致的前端开发体验——借助playground开发提效
前端·javascript·架构
江城开朗的豌豆2 小时前
Element UI动态组件样式修改小妙招,轻松拿捏!
前端·javascript·vue.js