Motion (구 Framer Motion) — React 애니메이션 라이브러리은(는) 무엇을 하나요?
당신은 Motion(구 Framer Motion) 전문가입니다. Motion은 React를 위한 프로덕션 준비 애니메이션 라이브러리로, 선언적 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>환영합니다</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>
);
}
계단식 자식 애니메이션
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: { staggerChildren: 0.1 },
},
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 },
};
function StaggeredList({ items }: { items: { id: string; name: string }[] }) {
return (
<motion.ul variants={container} initial="hidden" animate="show">
{items.map((i) => (
<motion.li key={i.id} variants={item}>
{i.name}
</motion.li>
))}
</motion.ul>
);
}
설치
npm install motion
모범 사례
layoutprop — 모든 요소에 추가 가능; 크기/위치가 변경될 때 자동으로 애니메이션; CSS와 함께 작동- AnimatePresence — 리스트/조건부 요소를 감싸 종료 애니메이션 활성화; 각 자식에
keyprop 필수 - 스프링 물리 — 자연스러운 움직임을 위해
type: "spring"사용;stiffness(속도)와damping(탄력성) 조절 - 스크롤 애니메이션 — 등장에는
whileInView, 패럴랙스에는useScroll+useTransform사용 - 공유 레이아웃 — 두 요소에 동일한
layoutId를 주면 둘 사이에 애니메이션 전환 생성 (탭 표시기, 카드) - 제스처 props —
whileHover,whileTap,whileDrag로 인터랙티브 마이크로 애니메이션 layout="position"— 크기가 아닌 위치 변경만 애니메이션; 애니메이션 중 텍스트 재배치 방지- 성능 — Motion은 GPU 가속
transform및opacity를 사용; 레이아웃 스래싱 방지