Motion (Framer Motion) — React UI 애니메이션 라이브러리은(는) 무엇을 하나요?
React를 위한 선언적 애니메이션. 스프링, 제스처, 레이아웃 애니메이션, 페이지 전환. GPU 가속, 프로덕션 준비 완료.
개요
- 저장소: github.com/motiondivision/motion (26K+ 스타)
- 언어: TypeScript / React
- 라이선스: MIT
- 설치:
npm install motion - 문서: motion.dev
- 참고: Framer Motion이 Motion으로 이름이 변경되었습니다.
motion/react에서 가져오세요.
핵심 API
기본 애니메이션
import { motion } from "motion/react";
// 마운트 시 애니메이션
<motion.div
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
transition={{ duration: 0.5 }}
>
안녕하세요
</motion.div>
// 언마운트 시 애니메이션 (AnimatePresence 필요)
import { AnimatePresence } from "motion/react";
<AnimatePresence>
{isVisible && (
<motion.div
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
>
내용
</motion.div>
)}
</AnimatePresence>
스프링 물리
<motion.div
animate={{ x: 100 }}
transition={{
type: "spring",
stiffness: 300,
damping: 20,
mass: 1,
}}
/>
// 프리셋
transition={{ type: "spring", bounce: 0.5 }} // 0 = 튕김 없음, 1 = 매우 많이 튕김
변형 (오케스트레이션 애니메이션)
const container = {
hidden: { opacity: 0 },
show: {
opacity: 1,
transition: {
staggerChildren: 0.1, // 자식 간 지연 시간
delayChildren: 0.3, // 초기 지연 시간
},
},
};
const item = {
hidden: { opacity: 0, y: 20 },
show: { opacity: 1, y: 0 },
};
<motion.ul variants={container} initial="hidden" animate="show">
{items.map((i) => (
<motion.li key={i} variants={item}>{i}</motion.li>
))}
</motion.ul>
제스처
// 호버
<motion.button
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
>
클릭하세요
</motion.button>
// 드래그
<motion.div
drag // 양축 드래그 활성화
dragConstraints={{ left: -100, right: 100, top: -50, bottom: 50 }}
dragElastic={0.2}
/>
레이아웃 애니메이션
// 레이아웃 변경 자동 애니메이션
<motion.div layout>
{isExpanded ? <확장된내용 /> : <접힌내용 />}
</motion.div>
// 공유 레이아웃 애니메이션 (요소 간 형태 변환)
<motion.div layoutId="card">
{/* layoutId가 일치하면 이 요소가 위치 간에 형태가 변환됩니다 */}
</motion.div>
스크롤 애니메이션
import { useScroll, useTransform, motion } from "motion/react";
function 시차섹션() {
const { scrollYProgress } = useScroll();
const y = useTransform(scrollYProgress, [0, 1], [0, -200]);
const opacity = useTransform(scrollYProgress, [0, 0.5, 1], [1, 1, 0]);
return (
<motion.div style={{ y, opacity }}>
시차 콘텐츠
</motion.div>
);
}
useAnimate (명령형)
import { useAnimate } from "motion/react";
function 내컴포넌트() {
const [scope, animate] = useAnimate();
async function handleClick() {
await animate(".box", { scale: 1.5 }, { duration: 0.3 });
await animate(".box", { rotate: 360 }, { duration: 0.5 });
await animate(".box", { scale: 1, rotate: 0 });
}
return (
<div ref={scope}>
<div className="box" onClick={handleClick}>클릭하세요</div>
</div>
);
}
키프레임
<motion.div
animate={{
x: [0, 100, 100, 0, 0],
y: [0, 0, 100, 100, 0],
rotate: [0, 90, 180, 270, 360],
}}
transition={{ duration: 2, repeat: Infinity }}
/>
전환 유형
// 스프링 (물리 값에 대한 기본값)
transition={{ type: "spring", stiffness: 100, damping: 10 }}
// Tween (지속 시간 기반)
transition={{ type: "tween", duration: 0.5, ease: "easeInOut" }}
// 이징 옵션
ease: "linear" | "easeIn" | "easeOut" | "easeInOut"
ease: [0.42, 0, 0.58, 1] // 사용자 정의 큐빅 베지어
// 반복
transition={{ repeat: Infinity, repeatType: "reverse", duration: 1 }}
// 지연
transition={{ delay: 0.5 }}
일반적인 패턴
페이지 전환
// 레이아웃 컴포넌트 내부
<AnimatePresence mode="wait">
<motion.div
key={pathname}
initial={{ opacity: 0, x: 20 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: -20 }}
transition={{ duration: 0.3 }}
>
{children}
</motion.div>
</AnimatePresence>
지연 리스트
const container = {
hidden: {},
show: { transition: { staggerChildren: 0.08 } },
};
const item = {
hidden: { opacity: 0, y: 15 },
show: { opacity: 1, y: 0, transition: { type: "spring", bounce: 0.3 } },
};
호버 시 확대 카드
<motion.div
whileHover={{ scale: 1.03, boxShadow: "0 10px 30px rgba(0,0,0,0.15)" }}
transition={{ type: "spring", stiffness: 400, damping: 25 }}
/>
모범 사례
- 변형 사용 — 부모/자식 애니메이션 오케스트레이션에 활용
- 스프링 물리 — 자연스러운 느낌의 모션에 사용 (선형 이징 피할 것)
- layout prop — 자동 레이아웃 변경 애니메이션에 사용
- AnimatePresence — 종료 애니메이션에 필수
- layoutId — 라우트 간 공유 요소 전환에 사용
- useScroll — 스크롤 연동 애니메이션 (시차, 진행 막대)에 사용
- whileHover/whileTap — 상호작용 피드백에 사용
- 자식 지연 — 변형
transition.staggerChildren을 통해 설정 - 애니메이션은 미묘하게 — UI 상호작용에 0.2-0.5초 지속 시간 사용
- GPU 가속 — Motion은 기본적으로 transform을 사용
Motion vs GSAP 사용 시기
| 항목 | Motion | GSAP |
|---|---|---|
| 프레임워크 | React 우선 | 프레임워크 중립 |
| 스타일 | 선언형 (JSX props) | 명령형 (함수 호출) |
| 레이아웃 애니메이션 | 내장 (매직) | 수동 |
| 스크롤 | useScroll 훅 | ScrollTrigger 플러그인 |
| 제스처 | 내장 (드래그, 호버, 탭) | Draggable 플러그인 |
| SVG 변형 | 제한적 | MorphSVGPlugin |
| 번들 크기 | ~30KB | ~25KB 코어 |
출처
- 저장소: github.com/motiondivision/motion
- 문서: motion.dev
- 예제: motion.dev/docs/react-quick-start