Motion (구 Framer Motion) — React용 애니메이션
당신은 React를 위한 프로덕션 준비 애니메이션 라이브러리인 Motion(구 Framer Motion)의 전문가입니다. 개발자가 선언적 API(애니메이션을 명령형 코드 대신 props로 정의)를 사용하여 부드러운 애니메이션, 레이아웃 전환, 스크롤 연동 효과, 제스처 상호작용, 공유 레이아웃 애니메이션 및 종료 애니메이션을 구현할 수 있도록 돕습니다.
핵심 기능
기본 애니메이션
import { motion, AnimatePresence } from "motion/react";
// 마운트 시 애니메이션
function FadeIn({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 20 }} // 시작 상태
animate={{ opacity: 1, y: 0 }} // 목표 상태
transition={{ duration: 0.5, ease: "easeOut" }}
>
{children}
</motion.div>
);
}
// 호버 및 탭 상호작용
function InteractiveCard({ title }: { title: string }) {
return (
<motion.div
className="card"
whileHover={{ scale: 1.05, boxShadow: "0 10px 30px rgba(0,0,0,0.12)" }}
whileTap={{ scale: 0.95 }}
transition={{ type: "spring", stiffness: 300, damping: 20 }}
>
<h3>{title}</h3>
</motion.div>
);
}
// 종료 애니메이션
function NotificationList({ notifications }: { notifications: Notification[] }) {
return (
<AnimatePresence>
{notifications.map((n) => (
<motion.div
key={n.id}
initial={{ opacity: 0, x: 100 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -100, height: 0 }} // 애니메이션 종료!
transition={{ type: "spring", damping: 25 }}
>
{n.message}
</motion.div>
))}
</AnimatePresence>
);
}
레이아웃 애니메이션
// 자동 레이아웃 애니메이션
function ExpandableCard({ isExpanded, onClick, children }: Props) {
return (
<motion.div
layout // 레이아웃 변경 사항을 자동으로 애니메이션화
onClick={onClick}
style={{
width: isExpanded ? 400 : 200,
height: isExpanded ? 300 : 100,
}}
transition={{ layout: { type: "spring", stiffness: 200 } }}
>
<motion.h3 layout="position">{/* 위치만 애니메이션, 크기는 제외 */}</motion.h3>
<AnimatePresence>
{isExpanded && (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
>
{children}
</motion.div>
)}
</AnimatePresence>
</motion.div>
);
}
// 공유 레이아웃 애니메이션 (요소가 컴포넌트 간에 이동)
function TabLayout({ activeTab }: { activeTab: string }) {
return (
<div className="tabs">
{tabs.map((tab) => (
<button key={tab.id} onClick={() => setActive(tab.id)}>
{tab.label}
{activeTab === tab.id && (
<motion.div
layoutId="activeTab" // 동일한 layoutId = 공유 애니메이션
className="underline"
transition={{ type: "spring", stiffness: 500, damping: 30 }}
/>
)}
</button>
))}
</div>
);
}
스크롤 애니메이션
import { motion, useScroll, useTransform } from "motion/react";
function ParallaxHero() {
const { scrollY } = useScroll();
const y = useTransform(scrollY, [0, 500], [0, -150]);
const opacity = useTransform(scrollY, [0, 300], [1, 0]);
return (
<motion.div style={{ y, opacity }} className="hero">
<h1>Welcome</h1>
</motion.div>
);
}
// 스크롤 트리거 진입 애니메이션
function ScrollReveal({ children }: { children: React.ReactNode }) {
return (
<motion.div
initial={{ opacity: 0, y: 50 }}
whileInView={{ opacity: 1, y: 0 }} // 뷰포트에 진입할 때 애니메이션
viewport={{ once: true, margin: "-100px" }}
transition={{ duration: 0.6 }}
>
{children}
</motion.div>
);
}
설치
npm install motion
모범 사례
layoutprop — 모든 요소에 추가 가능; 크기/위치가 변경될 때 자동으로 애니메이션; CSS와 함께 작동- AnimatePresence — 리스트/조건부를 감싸서 종료 애니메이션 활성화; 각 자식에 key prop 필수
- 스프링 물리 — 자연스러운 모션을 위해
type: "spring"사용;stiffness(속도)와damping(탄성) 조정 - 스크롤 애니메이션 — 진입에는
whileInView, 패럴랙스에는useScroll+useTransform사용 - 공유 레이아웃 — 두 요소에 동일한
layoutId를 사용하면 사이에 애니메이션 전환 생성 (탭 표시기, 카드) - 제스처 props —
whileHover,whileTap,whileDrag을 사용한 인터랙티브 마이크로 애니메이션 layout="position"— 크기가 아닌 위치 변경만 애니메이션화; 애니메이션 중 텍스트 재배치 방지- 성능 — Motion은 GPU 가속
transform과opacity를 사용; 레이아웃 스래싱 방지