dot-skills — Airbnb iOS SwiftUI 애니메이션 모범 사례
SwiftUI iOS 26 / Swift 6.2 앱을 위한 독단적이고 엄격한 애니메이션 제작 가이드입니다. 8개 카테고리에 걸쳐 50개의 규칙을 포함하며, Airbnb 엔지니어링 모션 패턴, Apple WWDC 세션 및 Apple Human Interface Guidelines에서 파생되었습니다. 모든 애니메이션 뷰에 @Equatable, 모든 스프링/타이밍 값에 모션 토큰, 레이아웃에 디자인 시스템 토큰을 의무화합니다.
필수 아키텍처 정렬
이 스킬은 swift-ui-architect 및 ios-design-system과 함께 작동하도록 설계되었습니다. 모든 코드 예제는 다음과 같은 동일한 절대적 제약 조건을 따릅니다:
- 모든 뷰에
@Equatable매크로 사용 (Airbnb는 스크롤 히치 15% 감소 측정) - 비즈니스 로직 트리거를 포함하는 복잡한 애니메이션 상태에
@Observable사용 - 뷰 소유 애니메이션 상태 (토글 부울, 드래그 오프셋)에
@State사용 - 디자인 시스템 토큰:
Spacing.xs/sm/md/lg,Radius.sm/md/lg— 하드코딩된 레이아웃 숫자 없음 - 모션 토큰:
Motion.standard/responsive/playful— 흩어져 있는 스프링 리터럴 없음 - 시맨틱 색상:
.backgroundSurface,.accentPrimary— 뷰에 원시 Color 리터럴 없음 - 기능 애니메이션은 프레젠테이션 전용으로 유지; 데이터/네트워크 관련 사항은 Data 패키지에 유지
범위 및 형제 스킬과의 관계
이 스킬은 모션 레이어입니다 — 유동적이고 성능이 뛰어난 애니메이션을 구축하는 방법을 가르칩니다. 형제 스킬과 함께 로드될 때:
| 형제 스킬 | 초점 | 이 스킬의 초점 |
|---|---|---|
swift-ui-architect | 아키텍처 (모듈식 MVVM-C, 라우트 셸, 프로토콜 경계) | 애니메이션 아키텍처 (모션 토큰, 스프링 선택, 오케스트레이션) |
ios-design-system | 디자인 시스템 인프라 (토큰, 스타일, 거버넌스) | 모션 토큰 및 애니메이션 컴포넌트 패턴 |
ios-hig | HIG 준수 패턴 | 모션 특정 HIG (모션 감소, 공간적 연속성) |
범위 외: 디자이너가 작성한 벡터 애니메이션 (Lottie를 After Effects 내보내기에 사용). 복잡한 UIKit 전환 컨트롤러 (Airbnb의 선언적 전환 프레임워크 참조). 이 스킬은 프로그래매틱 SwiftUI 애니메이션만 다룹니다.
클리닉 아키텍처 계약 (iOS 26 / Swift 6.2)
이 스킬의 모든 지침은 클리닉 모듈식 MVVM-C 아키텍처를 가정합니다:
- 기능 모듈은
Domain+DesignSystem만 임포트합니다 (Data또는 형제 기능은 절대 임포트하지 않음) - App 타겟은 수렴 지점이며
DependencyContainer, 구체적인 코디네이터 및 Route Shell 배선을 소유합니다 Domain은 순수 Swift로 유지되며 모델, 리포지토리,*Coordinating,ErrorRouting및AppError계약을 정의합니다Data는 SwiftData/네트워크/동기화/재시도/백그라운드 I/O를 소유하고 Domain 프로토콜을 구현합니다- 읽기/쓰기 흐름은 기본적으로 stale-while-revalidate 읽기 및 낙관적 큐 쓰기를 사용합니다
- ViewModel은 리포지토리 프로토콜을 직접 호출합니다 (기본 use-case/interactor 레이어 없음)
적용 시기
다음과 같은 경우 이 지침을 참조하세요:
- SwiftUI 뷰 또는 전환에 애니메이션 추가
- 제스처 기반 상호작용 구축 (드래그, 스와이프, 팬)
- 공간 전환 (확장/축소, 탐색 변형)으로 뷰 연결
- 마이크로 상호작용 디자인 (버튼 누름, 토글, 로딩 상태)
- 콘텐츠 변경을 물리적으로 느껴지도록 만들기 (숫자 롤, 심볼 교체)
- 다중 요소 애니메이션 시퀀스 안무 (KeyframeAnimator, PhaseAnimator)
- 디자인 시스템을 위한 모션 토큰 정의
- 성능, 접근성 및 아키텍처 규정 준수를 위한 애니메이션 코드 검토
우선순위별 규칙 카테고리
| 우선순위 | 카테고리 | 영향 | 접두사 | 규칙 수 |
|---|---|---|---|---|
| 1 | 스프링 물리 | 치명적 | spring- | 8 |
| 2 | 타이밍 & 느낌 | 치명적 | feel- | 6 |
| 3 | 제스처 연속성 | 높음 | gesture- | 7 |
| 4 | 공간 전환 | 높음 | spatial- | 6 |
| 5 | 마이크로 상호작용 | 높음 | micro- | 6 |
| 6 | 오케스트레이션 | 높음 | orch- | 5 |
| 7 | 공예 & 광택 | 높음 | craft- | 5 |
| 8 | 콘텐츠 모션 | 중간-높음 | content- | 5 |
빠른 참조
1. 스프링 물리 (치명적)
spring-motion-tokens— 모든 스프링 프리셋에 대해 모션 토큰을 caseless enum으로 정의spring-smooth-default— 모든 UI 전환에 .smooth 스프링을 기본값으로 사용spring-snappy-responsive— 응답성 상호작용에 .snappy 스프링 사용spring-bouncy-celebration— 장난기 넘치고 축하하는 순간에 .bouncy 스프링 사용spring-custom-parameters— response 및 dampingFraction으로 사용자 정의 스프링 조정spring-velocity-preservation— 스프링은 중단 시 속도 보존spring-never-linear— 대화형 UI에 linear 또는 easeInOut 절대 사용 금지spring-completion-chaining— 연결된 시퀀스에 withAnimation completion 사용
2. 타이밍 & 느낌 (치명적)
feel-250ms-max— UI 애니메이션을 250ms 미만으로 유지feel-faster-better— 더 빠른 애니메이션이 거의 항상 더 좋게 느껴짐feel-asymmetric-enter-exit— 진입 및 종료에 비대칭 타이밍 사용feel-distance-proportional— 지속 시간을 이동 거리에 일치시킴feel-haptic-sync— 햅틱 피드백을 시각적 애니메이션 키프레임에 동기화feel-stagger-timing— 30-50ms 간격으로 순차적 표시
3. 제스처 연속성 (높음)
gesture-rubber-band— 드래그 경계에서 러버 밴드gesture-momentum-dismiss— 속도 OR 거리 임계값에서 해제gesture-snap-points— 속도 인식 스냅 포인트 사용gesture-interruptible— 모든 제스처 애니메이션을 중단 가능하게 만듦gesture-scroll-drag-conflict— 스크롤 및 드래그 제스처 충돌 해결gesture-state-transient— 일시적 드래그 상태에 GestureState 사용gesture-projected-landing— 자연스러운 착지 위치를 위해 제스처 속도 투영
4. 공간 전환 (높음)
spatial-matched-geometry— 확장/축소 변형에 matchedGeometryEffect 사용spatial-zoom-navigation— 컬렉션 상세에 줌 탐색 전환 사용 (iOS 18)spatial-transition-origin— 전환을 트리거 위치에 고정spatial-hero-shared-element— 풍부한 히어로 애니메이션을 위해 여러 요소 ID 공유spatial-sheet-morph— 시트 프레젠테이션에 matchedGeometryEffect 사용spatial-tab-continuity— 탭 전환에서 공간 방향 유지
5. 마이크로 상호작용 (높음)
micro-button-press-scale— 촉각 피드백을 위해 누를 때 버튼을 0.97로 축소micro-haptic-pairing— 모든 시각적 상태 변경을 햅틱 피드백과 쌍으로 연결micro-symbol-effect— SF Symbol 애니메이션에 symbolEffect 사용micro-toggle-bounce— 토글 상태 변경에 바운스 추가micro-long-press-fill— 길게 누르기 동작에 점진적 채우기 애니메이션 적용micro-loading-phase— 유기적인 로딩 상태에 반복 스프링 사용
6. 오케스트레이션 (높음)
orch-phase-animator— 다단계 시퀀스에 PhaseAnimator 사용orch-keyframe-animator— 타임라인 정밀 모션에 KeyframeAnimator 사용orch-stagger-children— 오케스트레이션된 표시를 위해 자식 요소 순차적 표시orch-coordinated-entrance— 공유 트리거로 다중 요소 진입 조정orch-timeline-view— 연속 반복 애니메이션에 TimelineView 사용
7. 공예 & 광택 (높음)
craft-reduce-motion— 크로스페이드 폴백으로 accessibilityReduceMotion 준수craft-blur-bridge— 불완전한 전환 상태를 연결하기 위해 블러 사용craft-drawing-group— Metal 기반 복잡한 애니메이션에 drawingGroup() 사용craft-geometry-group— 레이아웃 애니메이션 전파를 격리하기 위해 geometryGroup() 사용craft-transaction-debug— Transaction을 사용하여 애니메이션 동작 디버그 및 재정의
8. 콘텐츠 모션 (중간-높음)
content-numeric-text— 숫자 변경에 contentTransition(.numericText) 사용content-scroll-transition— 스크롤 위치 효과에 scrollTransition 사용content-visual-effect— 위치 인식 애니메이션에 visualEffect 사용content-symbol-replace— contentTransition으로 심볼 교체 애니메이션 적용content-text-renderer— 문자 수준 애니메이션에 Text Renderer 사용 (iOS 18)
사용 방법
올바른/잘못된 코드 예제가 포함된 자세한 설명은 개별 참조 파일을 읽으세요:
참조 파일
| 파일 | 설명 |
|---|---|
| references/_sections.md | 카테고리 정의 및 순서 |
| assets/templates/_template.md | 새 규칙을 위한 템플릿 |
| metadata.json | 버전 및 참조 정보 |