고급 스크롤 애니메이션 스킬
이 스킬을 사용해야 하는 경우
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. "Fade Up Reveal"
헤드라인과 큰 텍스트 블록이 뷰포트에 들어올 때 사용합니다.
- 훅:
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](프리미엄 느낌을 위해 사용자 정의 easing이 중요)
B. "Parallax Image"
이미지가 스크롤 위치보다 약간 느리거나 빠르게 움직여야 합니다.
- 훅:
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. "Staggered List"
기능 그리드, 팀 멤버, 가격 카드 등에 사용합니다.
- 부모:
<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가 설치/구성되었는지 확인합니다. 그렇지 않으면 먼저 설정합니다.
- 텍스트 콘텐츠에 표준 Fade Up reveal을 적용합니다.
- 대형 미디어 자산(이미지/비디오 배경)에 패럴랙스를 추가합니다.
- 목록/그리드에 지연 reveal을 추가합니다.
- 프로젝트를 빌드하여 TypeScript 또는 Framer Motion 버전 불일치 오류가 없는지 확인합니다.
- 사용자에게 알립니다: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."