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 放置的。動畫乾脆且機械——不使用 ease-out,改用 steps() 或 power4.inOut。想像:如果編譯器有品味。
3. 軟性工程
淺色背景搭配溫暖中性色、寬敞的留白、優雅的襯線字型搭配乾淨的無襯線字體。流暢的動畫。感覺高級且平靜。想像:如果 Dieter Rams 設計了一個作品集。
4. 霓虹建築
深色基底,鮮豔的霓虹強調色(洋紅、電光藍、萊姆綠),玻璃擬態效果,發光效果。動畫流暢,近乎液態。基於網格的佈局,帶有重疊元素。想像:銀翼殺手遇上瑞士設計。
5. 類比數位
紙張紋理,手繪元素結合銳利的數位字型,微妙的顆粒疊層。溫暖的色調。動畫模仿物理運動——物體像紙張一樣滑動,像卡片一樣堆疊。想像:一位也熱愛素描的開發者。
區塊架構
一個強大的作品集應遵循此結構。每個區塊應感覺像自己的「場景」:
英雄區
前 3 秒最重要。從文字動畫開始——訪客應看到你的名字活過來。在背景中加入微妙的環境動畫(浮動粒子、變形形狀、漸層動畫)。信息要極為簡潔:姓名 + 一行自我介紹。
關於我 / 哲學
不要只是列出事實。表達一種世界觀。使用滾動觸發的揭示效果,逐行顯示文字。照片可有可無,但如果包含,請使用創意處理(雙色調、clip-path 揭示、視差偏移)。
技能 / 技術棧
決不要使用無聊的標誌網格。可以嘗試:軌道可視化、滾動跑馬燈、響應懸停的互動標籤、星座圖、或「自我打字」的終端風格清單。
專案
核心重點。每個專案都需要展現空間。可以使用:水平滾動畫廊、全螢幕堆疊卡片(固定並切換)、或使用滾動觸發揭示的可展開卡片。每個專案應展示:標題、簡短描述、使用技術、以及視覺元素(螢幕截圖、影片或創意插圖)。
聯絡 / 頁尾
有目的地結束。一個大字型的 CTA,也許是基於時間的問候語(「晚安 — 我們聊聊」),以及乾淨的聯絡連結。保持簡潔有力。
如需每種區塊類型的詳細 HTML/CSS/JS 範本,請參閱 references/portfolio-sections.md。
字體排版規則
從 Google Fonts 匯入字型。除非使用者指定框架,否則一律不要使用系統字型或 Inter/Roboto。
適用於開發者作品集的良好字型配對:
- 顯示字型 + 內文字型:「Clash Display」+「Satoshi」(透過 fontshare.com CDN)
- 顯示字型 + 內文字型:「Syne」+「Work Sans」(Google Fonts)
- 顯示字型 + 內文字型:「Space Grotesk」+「DM Sans」(Google Fonts)——僅在營造科技感時使用
- 等寬字型 + 無襯線字型:「JetBrains Mono」+「General Sans」(fontshare)——適用於終端機美學
- 襯線字型 + 無襯線字型:「Playfair Display」+「Source Sans 3」——適用於柔和/高級方向
- 顯示字型 + 內文字型:「Anybody」+「Instrument Sans」(Google Fonts)
- 顯示字型 + 內文字型:「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()而非個別觸發器 - 對摺疊以下(below the fold)的圖片加上
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 text)
- 互動元素需可透過鍵盤導航
- 足夠的色彩對比(內文至少 4.5:1)
建置流程
- 從美學方向開始——與使用者確認或根據他們的風格選擇
- 使用語意化區塊建立 HTML 結構
- 使用 CSS 進行樣式設定(自訂屬性、流暢字型、grid/flexbox)
- 逐區塊加入 GSAP 動畫
- 添加 ScrollTrigger 實現滾動驅動的揭示效果
- 加入互動性(懸停狀態、游標效果、微互動)
- 實現響應式設計
- 加入
prefers-reduced-motion處理 - 最佳化(懶加載、will-change、行動裝置的 matchMedia)
除非使用者指定框架,否則一律輸出包含嵌入式 CSS 和 JS 的單一 HTML 檔案。