GSAP 作品集技能
构建一个既像创意工作室制作、又保留软件工程师灵魂的作品集网站。目标绝不是一个“带着英雄区和卡片的公司式开发作品集”。目标是创造一种让人忍不住停下来浏览的体验。
核心理念
开发者的作品集通常以两种方式失败:要么太过乏味(白底、卡片网格、“你好,我是一名开发者”),要么过度使用与内容脱节的炫技效果。最佳的平衡点是有目的的戏剧性——每一个动画都应该感觉是在揭示某种东西,而不是为了动而动。
将作品集视作一个叙事,而非一个页面。访客被引导着经历一个故事:你是谁 → 你做了什么 → 你的思考方式 → 如何联系你。
GSAP 集成
始终从 CDN 加载 GSAP。使用 GSAP CDN(而非 cdnjs)上的最新版本:
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
对于 React 项目,通过 npm 安装:
npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
核心 GSAP 模式
1. 交错淡入 — 核心模式。永远不要一次性显示一组元素。
gsap.from('.skill-item', {
y: 60,
opacity: 0,
duration: 0.8,
stagger: 0.12,
ease: 'power3.out',
scrollTrigger: {
trigger: '.skills-section',
start: 'top 80%',
}
});
2. 文字拆分动画 — 将标题拆分为字符/单词并逐个动画。这是能添加的最高影响力的动画。如果可用,使用 SplitText 插件,或者手动用 <span> 拆分:
// 手动字符拆分
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
(char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? ' ' : char}</span>`
).join('');
gsap.from('.char', {
y: 120,
opacity: 0,
rotateX: -80,
stagger: 0.03,
duration: 1,
ease: 'power4.out',
});
3. 滚动驱动固定 — 固定页面区域,并在用户滚动时对其中内容进行动画。营造“电影感”。
gsap.timeline({
scrollTrigger: {
trigger: '.pinned-section',
start: 'top top',
end: '+=200%',
pin: true,
scrub: 1,
}
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');
4. 视差分层 — 通过不同的滚动速度赋予深度感。
gsap.to('.bg-layer', {
yPercent: -30,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true,
}
});
5. 鼠标磁吸 / 跟随鼠标效果 — 用于 CTA 或精选项目等交互元素。
const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
const rect = btn.getBoundingClientRect();
const x = e.clientX - rect.left - rect.width / 2;
const y = e.clientY - rect.top - rect.height / 2;
gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});
6. 水平滚动区域 — 非常适合项目展示。纵向滚动,但内容水平移动。
const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');
gsap.to(items, {
xPercent: -100 * (items.length - 1),
ease: 'none',
scrollTrigger: {
trigger: track,
pin: true,
scrub: 1,
end: () => '+=' + track.scrollWidth,
}
});
更多高级模式(包括形状变形、自定义鼠标轨迹、基于噪声的运动和 WebGL 集成提示)请阅读 references/gsap-patterns.md。
美学方向
对于软件工程师的作品集,以下美学方向效果最佳。每个项目选择一个——切勿混合:
1. 终端暗夜
深色背景,等宽字体搭配锐利无衬线字体,绿色/琥珀色/青色强调色点缀在黑色之上。感觉就像你在一个终端里——但一个漂亮的终端。使用扫描线叠加、闪烁光标、打字机动画。想象一下:黑客美学遇上编辑设计。
2. 野蛮代码
原始、暴露的结构。可见网格线、大号等宽字体、强烈的对比。元素看起来像是故意用 position: absolute 放置的。动画迅速而机械——不要使用缓出,使用 steps() 或 power4.inOut。想象一下:如果编译器有品味。
3. 柔光工程
浅色背景搭配温暖的中性色、充足的留白、优雅衬线字体(用于标题)搭配干净的无衬线字体。流畅、连续的动画。感觉高级而宁静。想象一下:Dieter Rams 设计作品集的样子。
4. 霓虹建筑师
深色基底、鲜艳的霓虹强调色(洋红、电光蓝、石灰)、玻璃态、发光效果。动画流畅,几乎是液态的。基于网格的布局,带有重叠元素。想象一下:银翼杀手 meets 瑞士设计。
5. 模拟数字
纸质纹理、手绘元素与锐利数字字体混合、微妙的颗粒叠加。暖色调色板。动画模拟物理运动——物体像纸一样滑动,像卡片一样堆叠。想象一下:一个也喜欢画画的开发者。
章节架构
一个优秀的作品集遵循以下结构。每个部分应该感觉像是一个独立的“场景”:
英雄区
最初的 3 秒最重要。从文字动画开始——访客应该看到你的名字鲜活起来。背景中包含微妙的氛围动画(浮动粒子、变形形状、渐变动画)。信息保持极其简洁:名字 + 一行身份介绍。
关于 / 理念
不要只罗列事实。表达一种世界观。使用滚动触发的揭示,逐行展示文字。照片可选,如果包含,使用创意处理(双色调、clip-path 揭示、视差偏移)。
技能 / 技术栈
永远不要使用无聊的 Logo 网格。尝试:轨道可视化、滚动条/跑马灯、悬停反应的交互式标签、星座图或“自打字”的终端风格列表。
项目
核心部分。每个项目都需要呼吸空间。使用:水平滚动画廊、全屏堆叠卡片(固定并过渡)、或带滚动触发揭示的可扩展卡片。每个项目应显示:标题、简短描述、所用技术、视觉展示(截图、视频或创意插图)。
联系 / 页脚
有目的地结束。大型排印 CTA,也许是基于时间的问候(“晚上好——我们聊聊”),以及整洁的联系链接。保持精炼。
每种章节类型的详细 HTML/CSS/JS 模板请阅读 references/portfolio-sections.md。
字体规则
从 Google Fonts 导入字体。永远不要使用系统字体或 Inter/Roboto。
适用于开发者作品集的好配搭:
- Display + Body: "Clash Display" + "Satoshi"(通过 fontshare.com CDN)
- Display + Body: "Syne" + "Work Sans"(Google Fonts)
- Display + Body: "Space Grotesk" + "DM Sans"(Google Fonts)——仅当走科技风格时
- Mono + Sans: "JetBrains Mono" + "General Sans"(fontshare)——用于终端美学
- Serif + Sans: "Playfair Display" + "Source Sans 3"——用于柔和/高级方向
- Display + Body: "Anybody" + "Instrument Sans"(Google Fonts)
- Display + Body: "Bricolage Grotesque" + "Geist"(通过 CDN)
加载方式:
<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">
或
<link href="https://fonts.googleapis.com/css2?family=Syne:wght@400;500;600;700;800&family=Work+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">
颜色规则
使用 CSS 自定义属性定义调色板。每个调色板需要:
--bg: 主背景--fg: 主文字--accent: 主要强调色--accent-2: 次要强调色(可选)--muted: 柔和文字 / 边框--surface: 卡片 / 区域背景
示例(终端暗夜):
:root {
--bg: #0a0a0a;
--fg: #e8e8e8;
--accent: #00ff88;
--accent-2: #0088ff;
--muted: #333;
--surface: #111;
}
示例(柔光工程):
:root {
--bg: #f8f5f0;
--fg: #1a1a1a;
--accent: #c45d3e;
--accent-2: #2d5a7b;
--muted: #b8b0a4;
--surface: #ffffff;
}
性能规则
GSAP 默认性能良好,但请遵循以下规则:
- 在动画元素上使用
will-change: transform - 优先使用
transform和opacity,而不是布局属性(width, height, top, left) - 对许多相似元素使用
ScrollTrigger.batch(),而不是单独触发器 - 对首屏以下图片添加
loading="lazy" - 保持页面总重量在 2MB 以下(不含视频)
- 使用
gsap.matchMedia()在移动设备上禁用重型动画:
gsap.matchMedia().add('(max-width: 768px)', () => {
// 此处放置更简单的移动端动画
});
响应式设计
每个部分必须在移动设备上正常工作。关键规则:
- 字体大小:使用
clamp()实现流体缩放——例如clamp(2rem, 5vw, 5rem) - 水平滚动区域应在移动设备上转换为垂直堆叠
- 固定部分:通过
gsap.matchMedia()减少固定持续时间或移除固定 - 触摸目标:按钮/链接至少 44px
- 在 375px、768px、1440px 断点处测试
可访问性
动画作品集仍需可访问:
- 尊重
prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
gsap.globalTimeline.timeScale(0); // 或完全跳过动画
}
- 语义化 HTML:使用
<main>、<section>、<nav>、<header>、<footer> - 所有图片添加 Alt 文本
- 交互元素可通过键盘导航
- 足够的颜色对比度(正文文本至少 4.5:1)
构建步骤
- 从美学方向开始——与用户确认或根据其气质选择
- 构建具有语义化章节的 HTML 结构
- 使用 CSS 进行样式化(自定义属性、流体排版、grid/flexbox)
- 逐章节引入 GSAP 动画
- 添加 ScrollTrigger 实现滚动驱动的揭示
- 添加交互性(悬停状态、光标效果、微交互)
- 实现响应式
- 添加
prefers-reduced-motion处理 - 优化(懒加载、will-change、移动端 matchMedia)
除非用户指定框架,否则始终输出一个内嵌 CSS 和 JS 的单一 HTML 文件。