UI 모션 패턴
두 가지 작업: 실제 제품 UI를 웹에서 애니메이션 처리하고, 재설계 없이 영상용 제품 UI를 재구축합니다. 두 작업 모두 동일한 토큰을 사용합니다.
1. 토큰 우선
모션을 한 번 정의하고 모든 곳에서 가져옵니다. 컴포넌트에 인라인 숫자를 사용하지 마세요.
// lib/motion-tokens.ts
export const motionTokens = {
duration: { instant: 0.1, fast: 0.18, normal: 0.3, slow: 0.5, scene: 0.7 },
easing: {
standard: [0.2, 0, 0, 1], // enter + move
exit: [0.4, 0, 1, 1], // leave
emphasized: [0.3, 0, 0, 1],
},
distance: { nudge: 4, small: 8, medium: 16, large: 32 },
stagger: 0.06, // 0.05에서 0.10 사이 유지
} as const;
export const springs = {
press: { type: "spring", stiffness: 600, damping: 38 }, // 버튼, 토글
snappy: { type: "spring", stiffness: 420, damping: 34 }, // 칩, 메뉴
gentle: { type: "spring", stiffness: 260, damping: 27 }, // 카드, 패널
layout: { type: "spring", stiffness: 320, damping: 30 }, // 재정렬, 크기 조정
camera: { type: "spring", stiffness: 140, damping: 20 }, // 큰 이동, 영상 전용
} as const;
질량 1 기준, 감쇠비 ζ = damping / (2·√stiffness): press 0.78, snappy 0.83, gentle 0.84, layout 0.84, camera 0.85 — 모두 0.75–0.90 대역 내에 있으며 (오버슛 ≤ ~6 %). 이 공식을 사용하여 브랜드에 맞게 조정하고, 이 테이블을 단일 정보 출처로 유지하세요.
2. 접근성 및 SSR
"use client";
import { useReducedMotion } from "motion/react";
export function useSafeMotion() {
const reduce = useReducedMotion();
return {
reduce,
// reduced motion: 변환 제거, 짧은 불투명도 변경(≤0.2초) 유지
enter: reduce ? { opacity: 1 } : { opacity: 1, y: 0 },
initial: reduce ? { opacity: 0 } : { opacity: 0, y: 8 },
transition: reduce ? { duration: 0.2 } : undefined,
};
}
- 첫 페인트에서 이미 보이는 요소에는
initial={false}를 사용하여 하이드레이션 플래시를 방지하세요. transform과opacity만 애니메이션 처리하세요. 루프에서width,height,top,left또는box-shadow를 절대 애니메이션 처리하지 말고,layout이나 scale을 대신 사용하세요.- 저사양 기기: 지속 시간을 단축하고 장식용 모션은 건너뛰세요.
3. 패턴 및 규칙
| 패턴 | 규칙 |
|---|---|
| 버튼 프레스 | whileTap={{ scale: 0.96 }}와 springs.press 사용; 100ms 이내 피드백 |
| 조건부 렌더링 | 안정적인 key와 함께 AnimatePresence로 감싸기; 모든 initial + animate는 exit를 가져야 함 |
| 페이지 / 라우트 전환 | AnimatePresence mode="wait": exit가 완료된 후 enter 시작 |
| 리스트 스태거 | staggerChildren 0.05–0.10초; 스태거 아이템은 ~8개로 제한, 나머지는 함께 나타남 |
| 재정렬 / 크기 조정 | 작은 서브트리(≲5 자식)에서만 layout 사용; 그 외에는 명시적 x/y 사용 |
| 모달 / 시트 | 포커스 트랩, Escape 닫힘, 스크롤 잠금, role="dialog", aria-modal="true", 포커스 반환 |
| 토스트 | 위치한 가장자리에서 진입; 호버/포커스 시 자동 닫힘 일시 중지 |
| 숫자 변경 | 수직 롤: 이전 값이 위로 흐려지며 나가고, 새 값이 아래에서 들어옴; font-variant-numeric: tabular-nums 사용 |
| 스크롤 시 나타남 | whileInView와 viewport={{ once: true }} 사용; 스크롤 아웃 시 절대 다시 애니메이션 처리하지 않음 |
| 로딩 → 성공 | 버튼이 압축 → 스피너 → 체크; 버튼 너비는 안정적으로 유지 |
4. 영상용 제품 UI 재구축
- 측정하고 추측하지 마세요. 제품 소스나 계산된 스타일에서 토큰을 가져오세요: 색상, 반경, 글꼴 패밀리/두께/자간, 간격, 아이콘 세트 및 선 두께. 실제 스크린샷에서 색상을 샘플링하여 비교하세요.
- 하이브리드 기본값. 실제 스크린샷을 컨텍스트로 사용; 애니메이션 처리할 요소만 픽셀 정렬로 재구축하여 그 위에 배치하세요.
- 명시적 승인 없이 재설계하지 마세요. 새로운 색상, 글꼴, 아이콘 또는 카피는 안 됩니다.
- 깨끗하게 캡처하세요. 로그아웃 상태 또는 데모 계정, 가상 데이터, 개인식별정보(PII) 없음, 사용자가 소유하지 않은 제3자 브랜드 없음.
- 탐색 가능하게. 영상에서는 모든 애니메이션 값을 절대 시간으로 구동하세요(
value = f(t)),motion/react런타임 상태가 아닙니다. 라이브 웹에는motion/react를, 렌더링된 영상에는 폐쇄형 스프링 또는 GSAP 타임라인을 사용하세요.
이 패턴을 영상 대신 웹사이트에서 사용할 때는 배송 전에 design-expert 검증 게이트(키보드, 포커스, reduced motion, 성능)를 실행하세요.