高級滾動動畫技能 是做什麼的?
何時使用此技能
- 當
tier-based-architecture技能要求「Premium 2D」或更高層級的網站時。 - 當使用者要求元素在向下滾動時淡入、滑上、縮放或固定時。
- 當建構以敘事為主的登陸頁面(例如 Apple 風格產品揭曉)。
語氣與語言方針 (重要)
- 始終以本地約旦/巴勒斯坦方言(اللهجة الأردنية والفلسطينية)與使用者溝通。
- 保持專業但平易近人:「يا هلا」,「رتبتلك السكرول」,「الأنيميشن صار جاهز」。
- 以阿拉伯語混合英文網路術語自然解釋技術選擇:「رح نستخدم
Framer Motionعشان حركات السكرول تطلع Smooth」。
1. 設置與基礎
如果缺少這些函式庫,請安裝它們:@studio-freight/lenis(用於流暢滾動基礎)和 framer-motion(用於元件層級動畫)。
Lenis 流暢滾動設定
任何使用此技能的網站都必須具備流暢滾動基礎,以確保動畫呈現高級感。
- 在頂層元件(例如
SmoothScrollProvider.tsx或layout.tsx)中設定Lenis。
// Lenis 設定範例
"use client";
import React, { useEffect } from 'react';
import Lenis from '@studio-freight/lenis';
export default function SmoothScroll({ children }: { children: React.ReactNode }) {
useEffect(() => {
const lenis = new Lenis({
duration: 1.2,
easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
orientation: 'vertical',
gestureOrientation: 'vertical',
smoothWheel: true,
wheelMultiplier: 1,
touchMultiplier: 2,
});
function raf(time: number) {
lenis.raf(time);
requestAnimationFrame(raf);
}
requestAnimationFrame(raf);
return () => {
lenis.destroy();
};
}, []);
return <>{children}</>;
}
2. 動畫模式 (Framer Motion)
建構區塊時,使用以下模式以達到高級感受:
A.「淡入上滑顯現」
用於進入視口時的標題和大型文字區塊。
- Hook:
useInView或<motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}> - 初始狀態:
opacity: 0, y: 40 - 動畫狀態:
opacity: 1, y: 0 - 過渡:
duration: 0.8, ease: [0.16, 1, 0.3, 1](自訂緩動對高級感受至關重要)。
B.「視差圖片」
圖片移動速度應略慢於或略快於滾動位置。
- Hook:
useScroll和useTransform。 - 實作方式:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
- 將圖片包裹在
overflow-hidden容器中,並對內層的motion.img套用y轉換。
C.「延遲列表」
適用於功能網格、團隊成員或定價卡片。
- 父層:
<motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}> - 變體 (父層):
{ hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } } - 變體 (子項目):
{ hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }
3. 工作流程檢查清單
- 複製指示。
- 確認 Lenis 是否已安裝/設定。若否,請先設定。
- 對文字內容套用標準的淡入上滑顯現效果。
- 為大型媒體資源(圖片/影片背景)加入視差效果。
- 為列表/網格加入延遲顯現效果。
- 建構專案以確認無 TypeScript 或 Framer Motion 版本不符錯誤。
- 告知使用者:「خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف。」