Motion (Framer Motion) — 스킬은(는) 무엇을 하나요?
이름: motion
목적: React에서 motion/react를 사용하여 부드럽고 접근성 있는 애니메이션을 구현합니다.
애니메이션, 제스처 또는 레이아웃 전환을 추가할 때 이 스킬을 사용하세요.
적용 대상: motion/react (motion, AnimatePresence, useScroll 등)를 사용할 때.
사용하지 말아야 할 경우: 애니메이션이 필요 없거나 컴포넌트가 순수 서버 렌더링될 때.
규칙
- 클라이언트 전용 경계: Motion은
'use client'가 필요합니다. 클라이언트 섬을 작게 유지하세요. - 간단하게 시작: 스프링 물리학을 추가하기 전에 먼저 opacity/translate로 시작하세요.
- 올바른 도구 사용: 진입/퇴장에는
AnimatePresence, 레이아웃에는layout, 제스처에는whileHover/whileTap을 사용하세요. - 동작 감소 설정 존중:
useReducedMotion()을 사용하세요. - 번들 크기 관리: 큰 모션 표면에는
LazyMotion을 사용하세요.
워크플로우
- UX 목적(피드백, 전환, 포커스)을 식별합니다.
- 가장 작은
'use client'경계를 추가합니다. - 진입/퇴장 또는 레이아웃 전환을 올바르게 구현합니다.
- 동작 감소 설정을 존중합니다.
- 성능과 번들 크기를 확인합니다.
체크리스트
구현 체크리스트
-
'use client'가 필요한 곳에만 사용 - 동작 감소 동작 정의됨
-
AnimatePresence가 조건부 UI를 래핑 - 레이아웃 전환에
layout사용
리뷰 체크리스트
- 애니메이션이 모든 렌더링에서 다시 실행되지 않음
- Motion 코드가 불필요하게 클라이언트 트리를 확장하지 않음
최소 예제
진입/퇴장
"use client";
import { AnimatePresence, motion } from "motion/react";
export function Toast({
open,
children,
}: {
open: boolean;
children: React.ReactNode;
}) {
return (
<AnimatePresence>
{open ? (
<motion.div
initial={{ opacity: 0, y: 8 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: 8 }}
transition={{ duration: 0.18 }}
>
{children}
</motion.div>
) : null}
</AnimatePresence>
);
}
레이아웃 애니메이션
"use client";
import { motion } from "motion/react";
export function Expander({ open }: { open: boolean }) {
return (
<motion.div layout className="overflow-hidden rounded-md border p-3">
<div className="font-medium">제목</div>
{open ? <div className="mt-2 text-sm">더 많은 내용...</div> : null}
</motion.div>
);
}
동작 감소 설정
"use client";
import { motion, useReducedMotion } from "motion/react";
export function FadeIn({ children }: { children: React.ReactNode }) {
const reduce = useReducedMotion();
return (
<motion.div
initial={reduce ? false : { opacity: 0, y: 6 }}
animate={reduce ? { opacity: 1 } : { opacity: 1, y: 0 }}
transition={{ duration: 0.2 }}
>
{children}
</motion.div>
);
}
일반적인 실수 / 함정
AnimatePresence없이 언마운트하기 (종료 애니메이션이 실행되지 않음)layout없이 레이아웃 애니메이션 적용- Motion을 거대한 클라이언트 트리에 배치
- 가상화 없이 큰 목록에 애니메이션 적용