dot-skills — Bonnes pratiques d'animations SwiftUI pour Airbnb iOS
Guide rigoureux et opinioné pour l'animation SwiftUI sous iOS 26 / Swift 6.2. Contient 50 règles réparties en 8 catégories, priorisées par impact. Issues des patterns de mouvement d'Airbnb Engineering, des sessions Apple WWDC et des Human Interface Guidelines d'Apple. Exige @Equatable sur chaque vue animée, des jetons de mouvement pour toutes les valeurs de ressort/timing, et des jetons du système de conception pour la mise en page.
Alignement architectural imposé
Ce skill est conçu pour fonctionner avec swift-ui-architect et ios-design-system. Tous les exemples de code suivent les mêmes contraintes non négociables :
- Macro
@Equatablesur chaque vue (Airbnb a mesuré une réduction de 15 % du scintillement de défilement) @Observablepour les états d'animation complexes impliquant des déclencheurs métier@Statepour les états d'animation appartenant à la vue (booléens de bascule, décalages de glissement)- Jetons du système de conception :
Spacing.xs/sm/md/lg,Radius.sm/md/lg— zéro nombre de mise en page codé en dur - Jetons de mouvement :
Motion.standard/responsive/playful— zéro littéral de ressort dispersé - Couleurs sémantiques :
.backgroundSurface,.accentPrimary— aucun littéralColorbrut dans les vues - Les animations de fonctionnalités restent purement de présentation ; les préoccupations de données/réseau restent dans le package Data
Portée et relation avec les skills frères
Ce skill constitue la couche de mouvement — il enseigne comment CONSTRUIRE des animations fluides et performantes. Lorsqu'il est chargé avec les skills frères :
| Skill frère | Son objectif | L'objectif de ce skill |
|---|---|---|
swift-ui-architect | Architecture (MVVM-C modulaire, coquilles de routes, frontières de protocoles) | Architecture d'animation (jetons de mouvement, sélection de ressorts, orchestration) |
ios-design-system | Infrastructure du système de conception (jetons, styles, gouvernance) | Jetons de mouvement et motifs de composants animés |
ios-hig | Conformité HIG patterns | HIG spécifique au mouvement (réduire le mouvement, continuité spatiale) |
Hors de portée : Animations vectorielles conçues par des designers (utilisez Lottie pour les exports After Effects). Contrôleurs de transition UIKit complexes (voir le framework de transition déclarative d'Airbnb). Ce skill couvre uniquement les animations SwiftUI programmatiques.
Contrat d'architecture clinic (iOS 26 / Swift 6.2)
Tous les conseils de ce skill supposent l'architecture clinic modulaire MVVM-C :
- Les modules de fonctionnalités importent uniquement
Domain+DesignSystem(jamaisData, jamais les fonctionnalités frères) - La cible App est le point de convergence et possède
DependencyContainer, les coordinateurs concrets et le câblage de Route Shell Domainreste du Swift pur et définit les modèles plus les contrats des dépôts,*Coordinating,ErrorRoutingetAppErrorDatapossède SwiftData/réseau/synchronisation/réessai/E/S en arrière-plan et implémente les protocoles Domain- Le flux de lecture/écriture par défaut utilise des lectures stale-while-revalidate et des écritures optimistes en file d'attente
- Les ViewModels appellent directement les protocoles de dépôt (pas de couche use-case/interactor par défaut)
Quand appliquer
Référez-vous à ces directives lorsque :
- Vous ajoutez des animations aux vues ou transitions SwiftUI
- Vous créez des interactions basées sur des gestes (glissement, balayage, panoramique)
- Vous connectez des vues avec des transitions spatiales (agrandissement/réduction, morphing de navigation)
- Vous concevez des micro-interactions (pression de bouton, bascule, états de chargement)
- Vous rendez les changements de contenu physiques (rouleaux de nombres, remplacements de symboles)
- Vous chorégraphiez des séquences d'animation multi-éléments (KeyframeAnimator, PhaseAnimator)
- Vous définissez des jetons de mouvement pour un système de conception
- Vous révisez du code d'animation pour la performance, l'accessibilité et la conformité architecturale
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe | Règles |
|---|---|---|---|---|
| 1 | Physique des ressorts | CRITIQUE | spring- | 8 |
| 2 | Timing et ressenti | CRITIQUE | feel- | 6 |
| 3 | Continuité gestuelle | ÉLEVÉ | gesture- | 7 |
| 4 | Transitions spatiales | ÉLEVÉ | spatial- | 6 |
| 5 | Micro-interactions | ÉLEVÉ | micro- | 6 |
| 6 | Orchestration | ÉLEVÉ | orch- | 5 |
| 7 | Finition et polissage | ÉLEVÉ | craft- | 5 |
| 8 | Mouvement de contenu | MOYEN-ÉLEVÉ | content- | 5 |
Référence rapide
1. Physique des ressorts (CRITIQUE)
spring-motion-tokens— Définir des jetons de mouvement comme une enum sans cas pour tous les préréglages de ressortspring-smooth-default— Utiliser par défaut le ressort .smooth pour toutes les transitions UIspring-snappy-responsive— Utiliser le ressort .snappy pour les interactions réactivesspring-bouncy-celebration— Utiliser le ressort .bouncy pour les moments ludiques et de célébrationspring-custom-parameters— Ajuster les ressorts personnalisés avec response et dampingFractionspring-velocity-preservation— Les ressorts préservent la vitesse lors d'une interruptionspring-never-linear— Ne jamais utiliser linear ou easeInOut pour l'UI interactivespring-completion-chaining— Utiliser la complétion withAnimation pour les séquences enchaînées
2. Timing et ressenti (CRITIQUE)
feel-250ms-max— Garder les animations UI sous 250 msfeel-faster-better— Les animations plus rapides sont presque toujours meilleuresfeel-asymmetric-enter-exit— Utiliser un timing asymétrique pour l'entrée et la sortiefeel-distance-proportional— Faire correspondre la durée à la distance parcouruefeel-haptic-sync— Synchroniser le retour haptique aux keyframes visuelles de l'animationfeel-stagger-timing— Échelonner les révélations à des intervalles de 30 à 50 ms
3. Continuité gestuelle (ÉLEVÉ)
gesture-rubber-band— Effet de bande élastique aux limites de glissementgesture-momentum-dismiss— Rejeter sur seuil de vitesse OU de distancegesture-snap-points— Utiliser des points d'accroche conscients de la vitessegesture-interruptible— Rendre toutes les animations gestuelles interruptiblesgesture-scroll-drag-conflict— Résoudre les conflits entre gestes de défilement et de glissementgesture-state-transient— Utiliser GestureState pour l'état transitoire de glissementgesture-projected-landing— Projeter la vitesse gestuelle pour une position d'atterrissage naturelle
4. Transitions spatiales (ÉLEVÉ)
spatial-matched-geometry— Utiliser matchedGeometryEffect pour les morphings d'agrandissement/réductionspatial-zoom-navigation— Utiliser la transition de navigation zoom pour le détail de collection (iOS 18)spatial-transition-origin— Ancrer les transitions à leur emplacement de déclenchementspatial-hero-shared-element— Partager plusieurs ID d'élément pour des animations hero richesspatial-sheet-morph— Utiliser matchedGeometryEffect pour les présentations de feuillesspatial-tab-continuity— Maintenir la direction spatiale dans les transitions d'onglets
5. Micro-interactions (ÉLEVÉ)
micro-button-press-scale— Mettre à l'échelle les boutons à 0.97 lors de l'appui pour un retour tactilemicro-haptic-pairing— Associer chaque changement d'état visuel à un retour haptiquemicro-symbol-effect— Utiliser symbolEffect pour les animations de symboles SFmicro-toggle-bounce— Ajouter un rebond aux changements d'état de basculemicro-long-press-fill— Animer un remplissage progressif pour les actions par appui longmicro-loading-phase— Utiliser un ressort répétitif pour les états de chargement organiques
6. Orchestration (ÉLEVÉ)
orch-phase-animator— Utiliser PhaseAnimator pour les séquences multi-étapesorch-keyframe-animator— Utiliser KeyframeAnimator pour un mouvement précis dans le tempsorch-stagger-children— Échelonner les éléments enfants pour des révélations orchestréesorch-coordinated-entrance— Coordonner l'entrée de plusieurs éléments avec un déclencheur partagéorch-timeline-view— Utiliser TimelineView pour les animations continues et répétitives
7. Finition et polissage (ÉLEVÉ)
craft-reduce-motion— Respecter accessibilityReduceMotion avec un repli de fondu enchaînécraft-blur-bridge— Utiliser le flou pour combler les états de transition imparfaitscraft-drawing-group— Utiliser drawingGroup() pour les animations complexes supportées par Metalcraft-geometry-group— Utiliser geometryGroup() pour isoler la propagation de l'animation de mise en pagecraft-transaction-debug— Utiliser Transaction pour déboguer et outrepasser le comportement d'animation
8. Mouvement de contenu (MOYEN-ÉLEVÉ)
content-numeric-text— Utiliser contentTransition(.numericText) pour les changements de nombrescontent-scroll-transition— Utiliser scrollTransition pour les effets de position de défilementcontent-visual-effect— Utiliser visualEffect pour les animations conscientes de la positioncontent-symbol-replace— Animer le remplacement de symbole avec contentTransitioncontent-text-renderer— Utiliser Text Renderer pour l'animation au niveau du caractère (iOS 18)
Comment utiliser
Lisez les fichiers de référence individuels pour des explications détaillées avec des exemples de code corrects/incorrects :
- Définitions des sections — Structure des catégories et niveaux d'impact
- Modèle de règle — Modèle pour ajouter de nouvelles règles
Fichiers de référence
| Fichier | Description |
|---|---|
| references/_sections.md | Définitions et ordre des catégories |
| assets/templates/_template.md | Modèle pour les nouvelles règles |
| metadata.json | Informations de version et de référence |