Motion을 이용한 애니메이션 구현
모든 애니메이션 작업에는 Motion 라이브러리(https://motion.dev)를 사용하세요.
빠른 시작
React (기본):
import { motion } from "motion/react"
// 기본 애니메이션
<motion.div animate={{ opacity: 1, y: 0 }} />
// 전환 설정 포함
<motion.div
animate={{ x: 100 }}
transition={{ type: "spring", stiffness: 100 }}
/>
핵심 패턴
1. 스프링 물리학 (권장)
<motion.div
animate={{ scale: 1 }}
transition={{
type: 'spring',
stiffness: 260,
damping: 20,
}}
/>
스프링 프리셋:
- 부드러운:
stiffness: 120, damping: 14 - 흔들리는:
stiffness: 180, damping: 12 - 딱딱한:
stiffness: 300, damping: 20
2. 제스처 상호작용
<motion.div
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
drag="x"
dragConstraints={{ left: -100, right: 100 }}
/>
3. 레이아웃 애니메이션
<motion.div layout>{/* 위치/크기가 변하는 콘텐츠 */}</motion.div>
4. 스크롤 연동 효과
import { useScroll, useTransform } from "motion/react"
const { scrollYProgress } = useScroll()
const opacity = useTransform(scrollYProgress, [0, 1], [1, 0])
<motion.div style={{ opacity }} />
5. 자식 요소 스태거
<motion.ul
variants={{
visible: { transition: { staggerChildren: 0.07 } },
}}
>
{items.map((item) => (
<motion.li
key={item}
variants={{
hidden: { opacity: 0, y: 20 },
visible: { opacity: 1, y: 0 },
}}
/>
))}
</motion.ul>
6. 진입/퇴장 애니메이션
import { AnimatePresence } from 'motion/react';
<AnimatePresence>
{show && <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} />}
</AnimatePresence>;
애니메이션 속성
변환 (GPU 가속, 성능 우수):
x, y, z- 이동scale, scaleX, scaleY- 크기 조절rotate, rotateX, rotateY, rotateZ- 회전skew, skewX, skewY- 기울이기
시각적 (성능에 영향을 줄 수 있으므로 신중하게 사용):
opacitybackground, backgroundColorcolorborderRadius
SVG 특화:
pathLength- 경로 그리기 애니메이션용pathOffset- 경로 오프셋pathSpacing- 대시 간격
접근성
항상 사용자 선호도를 존중하세요:
<motion.div
animate={{ x: 100 }}
transition={{
type: 'spring',
// 사용자가 모션 감소를 선호하면 애니메이션 비활성화
duration: 0,
}}
/>
Motion은 prefers-reduced-motion을 자동으로 처리합니다. 스프링은 즉시 전환됩니다.
성능 팁
- 가능하면 변환/불투명도만 애니메이션 처리 (GPU 가속)
layoutprop 사용 - 너비/높이를 수동으로 애니메이션하지 마세요- 스크롤 중 애니메이션 피하기
- 복잡한 애니메이션에는
will-change: transform사용 (Motion이 처리) - 동시 애니메이션 제한 - 한 번에 모두 실행하지 말고 스태거 효과 사용
디자인 원칙 (간략)
애니메이션을 사용해야 할 때
- 상태 전환 (로딩 → 성공)
- 공간적 변화 (뷰 진입/퇴장)
- 주의 끌기 (아껴서)
- 사용자 동작 확인
애니메이션을 사용하지 말아야 할 때
- 첫 번째 발생 후 반복되는 동작
- 성능이 중요한 경로
- 사용자 제어 스크롤
- 모든 단일 상호작용 (절제가 중요)
타이밍 가이드라인
- 마이크로 상호작용: 150-250ms
- 패널/모달 전환: 200-300ms
- 페이지 전환: 300-500ms
- 스프링: 물리학이 지속 시간 결정
스프링 vs 지속 시간
- 스프링 사용: 상호작용 요소, 제스처, 레이아웃 변경
- 지속 시간 사용: 의도적인 시퀀스, 안무, 로더
자세한 애니메이션 철학은 principles.md를 참조하세요.
일반 패턴
로딩 상태:
<motion.div
animate={{ rotate: 360 }}
transition={{
repeat: Infinity,
duration: 1,
ease: 'linear',
}}
/>
토스트 알림:
<motion.div
initial={{ x: 400, opacity: 0 }}
animate={{ x: 0, opacity: 1 }}
exit={{ x: 400, opacity: 0 }}
transition={{ type: 'spring', stiffness: 300, damping: 30 }}
/>
드로어:
<motion.div
initial={{ x: '-100%' }}
animate={{ x: 0 }}
exit={{ x: '-100%' }}
transition={{ type: 'spring', damping: 25 }}
/>
아코디언:
<motion.div
animate={{ height: isOpen ? 'auto' : 0 }}
transition={{ type: 'spring', bounce: 0 }}
style={{ overflow: 'hidden' }}
/>
리소스
- Motion 문서: https://motion.dev/docs/react
- Motion 예제: https://motion.dev/examples (100개 이상의 무료 예제)
- GitHub 저장소: https://github.com/motiondivision/motion
- 추가 리소스: 선별된 animation.dev 강의 및 볼트에 대해서는
resources.md를 참조하세요.
빠른 문제 해결
애니메이션이 실행되지 않나요?
- 요소가 조건부로 렌더링되는지 확인 (AnimatePresence 사용)
- 목표 값이 초기 값과 다른지 확인
- CSS가 재정의하는지 확인 (예:
!important)
성능 문제가 있나요?
- 변환 및 불투명도만 사용
- 치수 애니메이션 대신
layoutprop 사용 - 브라우저 DevTools 성능 탭 확인
레이아웃 애니메이션이 깜빡이나요?
- 부모에
position: relative가 있는지 확인 - 필요한 경우 부모와 자식 모두에
layout추가 - 충돌하는 CSS 전환 확인
참고 사항
- Motion은 MIT 라이선스, 프로덕션 준비 완료
- 하이브리드 엔진: 120fps, GPU 가속
- TypeScript 지원 내장
- 트리 셰이커블로 최적의 번들 크기 제공
- React 18+ (Suspense 포함)와 호환