Motion UI
제품 UI 모션과 제스처를 위한 연구 기반 플레이북: 19개의 패턴 파일로 구성되어 있으며, 각 파일에는 규칙, 안티 패턴, 좋은/나쁜 참고 자료, 접근성, 토큰, 구현 스케치 및 체크리스트가 포함되어 있습니다. 이 파일은 워크플로우, 논-네고시어블, 의사 결정 테이블 및 토큰 기본값을 제공합니다. 심층적인 내용은 패턴 파일을 참조하세요.
- 패턴 인덱스:
references/INDEX.md는 각 패턴과 한 줄 규칙을 나열합니다. - 패턴 파일:
references/patterns/<prefix>-<name>.md형식입니다. 접두사는mfound(목적, 타이밍, 안무, 축소 모션),mspring(스프링),mgesture(드래그, 모멘텀, 가장자리, 시트, 인터럽트),mtrans(진입/퇴장, 공간적 원점, 경로 전환, 마이크로 인터랙션, 스크롤 기반),mperf(성능) 및mref(리뷰 루브릭, 안티 패턴)입니다. - 스타터 토큰:
assets/motion-tokens.css입니다. 지속 시간, 이징 및 스태거 이름과 값은 dashboard-ui의tokens.css와 일치합니다. 라이트 및 다크 모드에서 독립적으로 작동합니다: dashboard-ui 역할 토큰은 0 특이성으로 선언되므로, dashboard-ui의tokens.css또는 프로젝트 자체 토큰이 동일한 역할 이름을 사용하는 경우 로드 순서에 관계없이 재정의됩니다. - 데이터 UI: 숫자 트위닝, 차트 전환, 연결된 탐색, 실시간 재계산 및 로딩 상태에는 dashboard-ui의
motion-*및prog-*패턴을 사용하세요. 이 스킬은 이를 반복하지 않습니다.
워크플로우
- 움직여야 하는지 먼저 결정하세요. 작업 이름을 지정하세요: 피드백, 연속성, 방향 전환, 주의 집중, 또는 (드물게) 즐거움. 발생 빈도와 키보드로 트리거되는지 여부를 추정한 후, 아래 빈도 표에서 해당 행을 선택하세요 (
mfound-purpose-and-frequency.md). 작업이 없거나, 키보드로 트리거되거나, 하루 100회 이상 발생하는 경우 중지: 애니메이션 없음. - 메커니즘을 선택하세요.
- 정적-정적 및 토글 (메뉴, 대화상자, 토글): CSS 전환 (
mfound-durations-and-easing.md) 또는 스프링linear()토큰 (mspring-css-linear-and-tokens.md). - 손가락이나 포인터로 구동되거나 속도로 인터럽트 가능: JS 스프링 (
mspring-parameters-and-mapping.md,mgesture-interruptibility-and-velocity.md). - 탐색: View Transitions (
mtrans-view-transitions-and-routes.md). - 스크롤 위치와 연결: 스크롤 기반 애니메이션 (
mtrans-scroll-driven-animations.md).
- 정적-정적 및 토글 (메뉴, 대화상자, 토글): CSS 전환 (
- 토큰에서 타이밍을 설정하세요. 요소별 지속 시간, 방향별 이징, 퇴장은 진입의 0.75배, 스프링은 지속 시간과 바운스로 표현합니다. 컴포넌트에서 원시 값을 절대 사용하지 마세요.
- 공간에 배치하세요. 트리거 지점에
transform-origin을 설정하고, 퇴장을 미러링하며, 앞뒤 이동을 일관성 있게 유지하고, 고정 크롬은 그대로 둡니다 (mtrans-spatial-origin-and-continuity.md). 최상위 레이어 요소의 진입/퇴장은mtrans-enter-exit-top-layer.md를 따르세요. - 제스처의 경우, 순서대로 적용하세요:
- 10픽셀 임계값의 1:1 추적 (
mgesture-direct-manipulation-drag.md); - 릴리스 시 투영 및 속도 (
mgesture-momentum-projection-and-snap.md); - 러버 밴딩 가장자리 (
mgesture-rubber-banding-and-bounds.md); - 시트 및 스와이프 규칙 (
mgesture-sheets-and-swipe-to-dismiss.md).
- 10픽셀 임계값의 1:1 추적 (
- 안무는 여러 항목이 변경될 때: 원인 먼저, 그 다음 부모, 그 다음 자식; 20–40ms 스태거, 상한 있음 (
mfound-choreography-and-stagger.md). - 비용을 낮추세요. transform과 opacity만 애니메이션하고, 전역
will-change를 사용하지 않으며, 다음 프레임에서 피드백을 칠합니다 (mperf-compositor-will-change-and-inp.md). - 축소 모션 버전을 대체(삭제 아님)로 작성하세요 (
mfound-reduced-motion-vestibular.md). - 프레임으로 리뷰하세요.
- 안티 패턴 검토 실행 (
mref-anti-patterns-gallery.md). - 프레임 스트립 캡처 (4배 느리게, 전체 및 축소 모션, 인터럽트 실행 포함) 및 페이지 내 감사.
- 18개 체크 루브릭 점수 계산 (
mref-motion-review-rubric.md). 필수 체크 항목이 0점인 항목 없이 80% 이상에서 출시. - 각 발견 사항을 체크 ID · 증거 · 수정 사항 및 검토하지 않은 항목과 함께 보고.
- 안티 패턴 검토 실행 (
논-네고시어블
다음 중 하나를 위반하려면 서면 사유가 필요합니다.
여부 및 지속 시간
- 모든 애니메이션에는 이름이 지정된 작업이 있습니다. 키보드 트리거 및 하루 100회 이상 액션에는 애니메이션이 없습니다.
- 애니메이션 길이와 관계없이 첫 번째 시각적 응답은 입력 후 100ms 이내에 나타납니다.
- 지속 시간은 토큰에서 가져옵니다 (100 / 150 / 240 / 400ms). UI 크롬에서는 400ms를 초과하는 항목이 없으며, 드문 경우에만 600ms에 도달할 수 있습니다.
- 진입은 ease-out; 화면 내 이동은 ease-in-out; 사용자가 기다리는 항목에는
ease-in을 사용하지 마세요. 퇴장은 진입의 약 0.75배입니다.
스프링 및 제스처 5. 스프링은 지속 시간 + 바운스로 작성합니다. UI 크롬에는 바운스 0 사용, 모멘텀이 있는 제스처 후에만 0.1–0.2 사용, opacity, 색상 또는 데이터 값에는 절대 사용하지 마세요. 6. 드래그된 요소는 잡는 지점부터 포인터를 1:1로 추적하며, 드래그 중에는 전환이 없습니다. 약 10px 후에 드래그를 커밋합니다. 7. 릴리스 시, 투영된 위치에 가장 가까운 대상으로 스냅하고, 릴리스 속도로 정착 스프링을 시작합니다. 8. 가장자리는 러버 밴딩 처리합니다. 손가락 아래에서 하드 스톱하지 않습니다. 9. 사용자가 영향을 줄 수 있는 모든 것은 현재 화면 값에서 인터럽트 가능합니다. 애니메이션 큐가 없으며 모션 중 입력이 차단되지 않습니다. 토글 UI는 키프레임이 아닌 전환을 사용합니다. 10. 파괴적인 제스처 액션은 릴리스 시 커밋하고 실행 취소를 제공합니다. 모든 제스처에는 버튼 또는 키보드 동등한 기능이 있습니다 (WCAG 2.5.7).
진입, 퇴장 및 탐색
11. scale(0)에서 절대 시작하지 마세요. opacity 0 + scale 0.95–0.97 또는 8–24px 이동부터 진입하고, transform-origin을 트리거 지점에 설정합니다.
12. 진입에는 @starting-style을 사용하고, 퇴장에는 display/overlay와 allow-discrete를 사용합니다. 보이는 최종 상태가 기본값이므로 지원되지 않는 브라우저에서도 작동합니다.
13. 경로 전환은 점진적 향상입니다. 먼저 데이터를 준비한 다음 전환합니다. 전환 유형에 따라 기본 cross-fade 또는 16–24px 방향 이동을 사용하고, 1–3개의 공유 요소를 지정한 다음 포커스를 이동합니다.
14. 토스트는 정보의 유일한 사본을 보유하지 않습니다. 오류는 자동으로 사라지지 않습니다. 실행 취소 토스트는 최소 8초 동안 유지되며 해당 액션은 토스트 외부에도 존재합니다. 타이머는 호버, 포커스 및 숨겨진 탭에서 일시 중지됩니다 (dashboard-ui comp-notifications-alerts.md).
성능 및 안전
15. 작은 컨트롤보다 큰 항목에서는 transform 계열 속성과 opacity만 애니메이션합니다. transition: all 금지. will-change는 임시적이며 측정 후에만 사용합니다.
16. prefers-reduced-motion: reduce에서 공간 모션을 150ms 이하의 페이드로 대체하고, 피드백을 유지하며, 1:1 드래그 추적을 유지하고, 바운스를 제거합니다. 전역 0.01ms 킬 스위치를 절대 출시하지 않으며, JS 애니메이션도 설정을 존중해야 합니다.
17. 제품 UI에서 시차, 스크롤 하이재킹, 전체 뷰포트 확대/축소 또는 유휴 루핑 모션을 금지합니다. 5초를 초과하는 자동 재생에는 일시 중지 컨트롤이 있으며, 초당 3회 이상 깜빡이지 않아야 합니다.
18. 코드나 기억이 아닌 캡처된 프레임으로 모션을 리뷰합니다.
의사 결정 테이블
빈도 → 모션 (mfound-purpose-and-frequency.md)
| 빈도 | 모션 |
|---|---|
| 키보드 트리거 또는 하루 100회 이상 (스킬의 기준) | 없음 |
| 하루 수십 회 | 100–150ms 페이드, 약간의 스케일 가능; 이동 없음, 바운스 없음 |
| 세션당 몇 회 | 150–240ms, 8–24px 이동 가능 |
| 드물게 (첫 실행, 큰 성공) | 최대 400–600ms, 바운스 허용 스프링 |
메커니즘 (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)
| 상황 | 사용 |
|---|---|
| 색상, opacity, 상태 변경 | CSS 전환, linear 또는 ease-out |
| 중간에 역전될 수 있는 토글 요소 | CSS 전환 (키프레임 절대 금지) |
| 스프링 느낌의 정적-정적 공간 모션 | CSS 스프링 linear() 토큰 + 자체 지속 시간 |
| 드래그 또는 플릭 후 릴리스, 또는 속도로 재타겟팅 | JS 스프링 (Motion, React Spring, SwiftUI, Compose) |
| 레이아웃 변경 (재정렬, 크기 조정, 확장) | FLIP, Motion layout, 또는 View Transition |
| 페이지 또는 경로 변경 | View Transition (동일 또는 교차 문서) |
| 스크롤러를 통한 진행 | 스크롤 기반 애니메이션 |
요소별 지속 시간 및 이징 (mfound-durations-and-easing.md)
| 요소 | 지속 시간 | 곡선 |
|---|---|---|
| 누름, 토글, 호버 | 100ms | ease-out (누름 scale 0.97) |
| 툴팁, 메뉴, 팝오버 | 진입 150ms / 퇴장 110ms | 진입 ease-out, 퇴장 ease-in 또는 페이드 아웃 |
| 대화상자, 토스트 | 진입 240ms / 퇴장 180ms | 진입 ease-out, 퇴장 ease-in 또는 페이드 아웃 |
| 시트, 서랍 | 240–400ms | --motion-ease-drawer, 또는 드래그 후 스프링 |
| 컨테이너 변환 (카드 → 상세) | 400ms | 강조 |
| 경로 cross-fade | 150–250ms | linear |
스프링 사전 설정 (mspring-parameters-and-mapping.md)
| 토큰 | 지속 시간 / 바운스 | 사용 |
|---|---|---|
spring-fast | 0.24 s / 0 | 토글, 작은 컨트롤 |
spring-default | 0.3 s / 0 | 메뉴, 시트 정착, 레이아웃 |
spring-slow | 0.45 s / 0 | 전체 화면 표면 |
spring-snappy | 0.3 s / 0.15 | 플릭 후 릴리스, 스냅 |
spring-playful | 0.4 s / 0.3 | 드문 즐거움 전용 |
라이브러리 매개변수 (Motion, React Spring, SwiftUI, Material 3)는 mspring-parameters-and-mapping.md의 하나의 공식에서 비롯됩니다.
제스처 임계값 (mgesture-*)
| 값 | 기본값 |
|---|---|
| 드래그 시작 / 축 잠금 | 10 px |
| 속도 샘플 창 | 100 ms |
| 투영 감속 | ms당 0.998 (빠른 페이지 전환의 경우 0.99) |
| 플릭 커밋 | > 400 px/s |
| 시트 닫힘 | 높이의 25% 이상 드래그 또는 플릭 |
| 러버 밴드 상수 | 0.55 (일반적인 근사치) |
토큰 기본값
전체 세트는 assets/motion-tokens.css에 있습니다.
| 그룹 | 기본값 |
|---|---|
| 지속 시간 | instant 0 · micro 100 · short 150 · medium 240 · long 400 ms · 퇴장 비율 0.75 |
| 이징 | standard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1) |
| 스프링 (CSS) | --motion-spring-{fast,default,slow,snappy,playful} 및 일치하는 -dur (360 / 450 / 670 / 420 / 660 ms) |
| 지오메트리 | scale-from 0.96 · press 0.97 · distance 8 / 16 / 24 px |
| 안무 | stagger 30 ms · max 300 ms (메뉴에서는 150 ms) |
| 축소 모션 | 공간 토큰은 0 또는 1로 축소됨; 페이드는 자체 타이밍 유지 |
이 스킬 적용 방법
- 구축 시:
assets/motion-tokens.css를 로드하거나 프로젝트 토큰에 매핑합니다.- 플랫폼 기능을 선호합니다: CSS 전환,
@starting-style,<dialog>및 popover API, View Transitions, 스크롤 기반 애니메이션,linear(). 제스처와 속도에만 JS 라이브러리를 사용합니다. - TypeScript
any타입을 절대 사용하지 마세요.
- 리뷰 시: 먼저 프레임을 캡처한 다음 안티 패턴 갤러리와 루브릭을 실행합니다. 체크, 점수, 증거 및 수정 사항을 심각도 순서로 정렬된 표로 보고하고, 검토하지 않은 항목을 나열합니다.
- 프로젝트에 모션 시스템이 있는 경우 (M3, Carbon, 자체 토큰): 해당 토큰이 우선합니다. 이 역할에 매핑하고 차이점에 플래그를 지정합니다.
- 규칙이 충돌할 때: 접근성 및 사용자 제어 (축소 모션, 인터럽트 가능, 스크롤 하이재킹 금지)가 표현력보다 우선하며, 빈도가 즐거움보다 우선합니다.