dot-skills — Airbnb iOS SwiftUI Animations Best Practices
Meinungsstarke, strenge Anleitungen zur Animationsgestaltung für SwiftUI iOS 26 / Swift 6.2 Apps. Enthält 50 Regeln in 8 Kategorien, priorisiert nach Auswirkung. Abgeleitet von den Motion-Entwurfsmustern von Airbnb Engineering, Apple WWDC-Sessions und den Apple Human Interface Guidelines. Erzwingt @Equatable auf jeder animierten View, Motion-Tokens für alle Feder-/Timing-Werte und Design-System-Tokens für das Layout.
Erzwungene Architekturausrichtung
Dieser Skill ist für die Zusammenarbeit mit swift-ui-architect und ios-design-system konzipiert. Alle Codebeispiele folgen denselben nicht verhandelbaren Einschränkungen:
@Equatable-Makro auf jeder View (Airbnb hat eine Reduzierung des Scroll-Rucks um 15 % gemessen)@Observablefür komplexe Animationszustände, die Geschäftslogik-Trigger beinhalten@Statefür ansichtseigene Animationszustände (Umschalt-Booleans, Zieh-Offsets)- Design-System-Tokens:
Spacing.xs/sm/md/lg,Radius.sm/md/lg— keine hartcodierten Layout-Zahlen - Motion-Tokens:
Motion.standard/responsive/playful— keine verstreuten Feder-Literale - Semantische Farben:
.backgroundSurface,.accentPrimary— keine rohen Color-Literale in Views - Feature-Animationen bleiben präsentationsorientiert; Daten-/Netzwerk-Belange bleiben im Data-Paket
Umfang & Beziehung zu Schwester-Skills
Dieser Skill ist die Motion-Ebene — er lehrt, wie man flüssige, leistungsstarke Animationen ERSTELLT. Wenn er zusammen mit Schwester-Skills geladen wird:
| Schwester-Skill | Sein Fokus | Fokus dieses Skills |
|---|---|---|
swift-ui-architect | Architektur (modulare MVVM-C, Route Shells, Protokollgrenzen) | Animationsarchitektur (Motion-Tokens, Federauswahl, Orchestrierung) |
ios-design-system | Design-System-Infrastruktur (Tokens, Stile, Governance) | Motion-Tokens und animierte Komponentenmuster |
ios-hig | HIG-konforme Muster | Motion-spezifische HIG (Reduzierte Bewegung, räumliche Kontinuität) |
Nicht im Fokus: Designererstellte Vektor-Animationen (verwenden Sie Lottie für After Effects-Exporte). Komplexe UIKit-Übergangs-Controller (siehe Airbnbs deklaratives Übergangs-Framework). Dieser Skill behandelt nur programmatische SwiftUI-Animationen.
Klinik-Architekturvertrag (iOS 26 / Swift 6.2)
Alle Anleitungen in diesem Skill gehen von der modularen MVVM-C-Klinik-Architektur aus:
- Feature-Module importieren nur
Domain+DesignSystem(niemalsData, niemals Schwester-Features) - Das App-Target ist der Konvergenzpunkt und besitzt den
DependencyContainer, konkrete Koordinatoren und die Route-Shell-Verdrahtung Domainbleibt reines Swift und definiert Modelle sowie Repository-,*Coordinating-,ErrorRouting- undAppError-VerträgeDatabesitzt SwiftData/Netzwerk/Sync/Retry/Hintergrund-I/O und implementiert Domain-Protokolle- Der Lese-/Schreibfluss standardmäßt auf Stale-While-Revalidate-Lesevorgänge und optimistische Warteschlangen-Schreibvorgänge
- ViewModels rufen Repository-Protokolle direkt auf (keine Standard-Use-Case-/Interactor-Ebene)
Wann anzuwenden
Beachten Sie diese Richtlinien, wenn:
- Animationen zu SwiftUI-Views oder -Übergängen hinzugefügt werden
- Gestengetriebene Interaktionen (Ziehen, Wischen, Schwenken) erstellt werden
- Views mit räumlichen Übergängen (Auf-/Zuklappen, Navigations-Morphs) verbunden werden
- Mikrointeraktionen (Tastendruck, Umschalter, Ladezustände) entworfen werden
- Inhaltsänderungen physisch wirken sollen (Zahlendrehungen, Symbolersetzungen)
- Mehrere Elemente in Animationssequenzen choreografiert werden (KeyframeAnimator, PhaseAnimator)
- Motion-Tokens für ein Design-System definiert werden
- Animationscode auf Leistung, Zugänglichkeit und Architektureinhaltung überprüft wird
Regelkategorien nach Priorität
| Priorität | Kategorie | Auswirkung | Präfix | Regeln |
|---|---|---|---|---|
| 1 | Federphysik | KRITISCH | spring- | 8 |
| 2 | Timing & Gefühl | KRITISCH | feel- | 6 |
| 3 | Gestenkontinuität | HOCH | gesture- | 7 |
| 4 | Räumliche Übergänge | HOCH | spatial- | 6 |
| 5 | Mikrointeraktionen | HOCH | micro- | 6 |
| 6 | Orchestrierung | HOCH | orch- | 5 |
| 7 | Handwerk & Politur | HOCH | craft- | 5 |
| 8 | Inhaltsbewegung | MITTEL-HOCH | content- | 5 |
Kurzreferenz
1. Federphysik (KRITISCH)
spring-motion-tokens— Motion-Tokens als eine enum ohne cases für alle Feder-Voreinstellungen definierenspring-smooth-default— Standardmäßig.smooth-Feder für alle UI-Übergänge verwendenspring-snappy-responsive—.snappy-Feder für reaktionsschnelle Interaktionen verwendenspring-bouncy-celebration—.bouncy-Feder für verspielte und feierliche Momente verwendenspring-custom-parameters— Benutzerdefinierte Federn mitresponseunddampingFractionabstimmenspring-velocity-preservation— Federn bewahren die Geschwindigkeit bei Unterbrechungspring-never-linear— Niemals linear oder easeInOut für interaktive UIs verwendenspring-completion-chaining—withAnimation-Completion für verkettete Sequenzen verwenden
2. Timing & Gefühl (KRITISCH)
feel-250ms-max— UI-Animationen unter 250 ms haltenfeel-faster-better— Schnellere Animationen fühlen sich fast immer besser anfeel-asymmetric-enter-exit— Asymmetrisches Timing für Ein- und Ausgang verwendenfeel-distance-proportional— Dauer an die zurückgelegte Strecke anpassenfeel-haptic-sync— Haptisches Feedback mit visuellen Animations-Keyframes synchronisierenfeel-stagger-timing— Enthüllungen in 30-50-ms-Intervallen staffeln
3. Gestenkontinuität (HOCH)
gesture-rubber-band— Gummiartig federn an Ziehgrenzengesture-momentum-dismiss— Schließen bei Schwellenwert für Geschwindigkeit ODER Distanzgesture-snap-points— Geschwindigkeitsbewusste Einrastpunkte verwendengesture-interruptible— Alle Gestenanimationen unterbrechbar machengesture-scroll-drag-conflict— Scroll- und Zieh-Gestenkonflikte auflösengesture-state-transient— GestureState für vorübergehenden Zieh-Zustand verwendengesture-projected-landing— Gesten-Geschwindigkeit für eine natürliche Landeposition projizieren
4. Räumliche Übergänge (HOCH)
spatial-matched-geometry— matchedGeometryEffect für Auf-/Zuklapp-Morphs verwendenspatial-zoom-navigation— Zoom-Navigationsübergang für Sammlungsdetails verwenden (iOS 18)spatial-transition-origin— Übergänge an ihrem Auslöseort verankernspatial-hero-shared-element— Mehrere Element-IDs für reichhaltige Helden-Animationen teilenspatial-sheet-morph— matchedGeometryEffect für Sheet-Präsentationen verwendenspatial-tab-continuity— Räumliche Richtung in Tab-Übergängen beibehalten
5. Mikrointeraktionen (HOCH)
micro-button-press-scale— Schaltflächen bei Druck auf 0,97 skalieren für taktiles Feedbackmicro-haptic-pairing— Jede visuelle Zustandsänderung mit haptischem Feedback paarenmicro-symbol-effect— symbolEffect für SF-Symbol-Animationen verwendenmicro-toggle-bounce— Hüpfen zu Umschaltzustandsänderungen hinzufügenmicro-long-press-fill— Progressives Füllen für Langdruck-Aktionen animierenmicro-loading-phase— Wiederholende Feder für organische Ladezustände verwenden
6. Orchestrierung (HOCH)
orch-phase-animator— PhaseAnimator für mehrschrittige Sequenzen verwendenorch-keyframe-animator— KeyframeAnimator für zeitlich präzise Bewegung verwendenorch-stagger-children— Kind-Elemente für orchestrierte Enthüllungen staffelnorch-coordinated-entrance— Mehrelement-Eingänge mit gemeinsamem Auslöser koordinierenorch-timeline-view— TimelineView für kontinuierliche, sich wiederholende Animationen verwenden
7. Handwerk & Politur (HOCH)
craft-reduce-motion— accessibilityReduceMotion mit Crossfade-Fallback respektierencraft-blur-bridge— Unschärfe verwenden, um unvollkommene Übergangszustände zu überbrückencraft-drawing-group— drawingGroup() für Metal-gestützte komplexe Animationen verwendencraft-geometry-group— geometryGroup() verwenden, um die Ausbreitung von Layout-Animationen zu isolierencraft-transaction-debug— Transaction verwenden, um das Animationsverhalten zu debuggen und zu überschreiben
8. Inhaltsbewegung (MITTEL-HOCH)
content-numeric-text— contentTransition(.numericText) für Zahlenänderungen verwendencontent-scroll-transition— scrollTransition für scrollpositionsabhängige Effekte verwendencontent-visual-effect— visualEffect für positionsbewusste Animationen verwendencontent-symbol-replace— Symbolersetzung mit contentTransition animierencontent-text-renderer— Text Renderer für zeichenweise Animation verwenden (iOS 18)
Wie zu verwenden
Einzelne Referenzdateien für detaillierte Erklärungen mit falschen/richtigen Codebeispielen lesen:
- Abschnittsdefinitionen — Kategoriestruktur und Auswirkungsstufen
- Regelvorlage — Vorlage zum Hinzufügen neuer Regeln
Referenzdateien
| Datei | Beschreibung |
|---|---|
| references/_sections.md | Kategoriendefinitionen und Reihenfolge |
| assets/templates/_template.md | Vorlage für neue Regeln |
| metadata.json | Versions- und Referenzinformationen |