dot-skills — Melhores Práticas de Animações SwiftUI iOS da Airbnb
Guia opinativo e rigoroso de animação para aplicativos SwiftUI iOS 26 / Swift 6.2. Contém 50 regras em 8 categorias, priorizadas por impacto. Derivado dos padrões de engenharia de motion da Airbnb, sessões da Apple WWDC e Diretrizes de Interface Humana da Apple. Exige @Equatable em toda view animada, tokens de motion para todos os valores de spring/timing e tokens do sistema de design para layout.
Alinhamento de Arquitetura Obrigatório
Este skill foi projetado para funcionar em conjunto com swift-ui-architect e ios-design-system. Todos os exemplos de código seguem as mesmas restrições inegociáveis:
- Macro
@Equatableem toda view (a Airbnb mediu redução de 15% em travamentos de scroll) @Observablepara estado de animação complexo que envolve gatilhos de lógica de negócios@Statepara estado de animação de propriedade da view (booleans de alternância, deslocamentos de arrasto)- Tokens do sistema de design:
Spacing.xs/sm/md/lg,Radius.sm/md/lg— zero números de layout codificados - Tokens de motion:
Motion.standard/responsive/playful— zero literais de spring dispersos - Cores semânticas:
.backgroundSurface,.accentPrimary— sem literais de cor brutos nas views - Animações de recursos permanecem apenas como apresentação; preocupações com dados/rede permanecem no pacote Data
Escopo e Relacionamento com Skills Irmãos
Este skill é a camada de motion — ele ensina como CONSTRUIR animações fluidas e de alto desempenho. Quando carregado junto com skills irmãos:
| Skill Irmão | Seu Foco | Foco Deste Skill |
|---|---|---|
swift-ui-architect | Arquitetura (MVVM-C modular, shells de rota, limites de protocolo) | Arquitetura de animação (tokens de motion, seleção de spring, orquestração) |
ios-design-system | Infraestrutura do sistema de design (tokens, estilos, governança) | Tokens de motion e padrões de componentes animados |
ios-hig | Conformidade com HIG | Motion específico para HIG (reduzir motion, continuidade espacial) |
Fora do escopo: Animações vetoriais criadas por designers (use Lottie para exportações do After Effects). Controladores complexos de transição UIKit (consulte o framework de transição declarativa da Airbnb). Este skill cobre apenas animações programáticas em SwiftUI.
Contrato de Arquitetura Clínica (iOS 26 / Swift 6.2)
Todas as orientações neste skill assumem a arquitetura clínica modular MVVM-C:
- Módulos de recurso importam apenas
Domain+DesignSystem(nuncaData, nunca recursos irmãos) - O target App é o ponto de convergência e possui
DependencyContainer, coordenadores concretos e a fiação do Route Shell Domainpermanece Swift puro e define modelos mais contratos de repositório,*Coordinating,ErrorRoutingeAppErrorDatapossui SwiftData/rede/sincronização/repetição/E/S de fundo e implementa os protocolos de Domain- O fluxo de leitura/gravação padrão é leituras stale-while-revalidate e gravações otimistas em fila
- ViewModels chamam protocolos de repositório diretamente (sem camada de caso de uso/interator padrão)
Quando Aplicar
Consulte estas diretrizes ao:
- Adicionar animações a views SwiftUI ou transições
- Construir interações baseadas em gestos (arrastar, deslizar, pan)
- Conectar views com transições espaciais (expandir/colapsar, morphs de navegação)
- Projetar microinterações (pressionar botão, alternar, estados de carregamento)
- Fazer com que mudanças de conteúdo pareçam físicas (rolagem de números, substituição de símbolos)
- Coreografar sequências de animação com múltiplos elementos (KeyframeAnimator, PhaseAnimator)
- Definir tokens de motion para um sistema de design
- Revisar código de animação para conformidade com desempenho, acessibilidade e arquitetura
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Prefixo | Regras |
|---|---|---|---|---|
| 1 | Física Spring | CRÍTICO | spring- | 8 |
| 2 | Temporização e Sensação | CRÍTICO | feel- | 6 |
| 3 | Continuidade de Gestos | ALTO | gesture- | 7 |
| 4 | Transições Espaciais | ALTO | spatial- | 6 |
| 5 | Microinterações | ALTO | micro- | 6 |
| 6 | Orquestração | ALTO | orch- | 5 |
| 7 | Artesanato e Polimento | ALTO | craft- | 5 |
| 8 | Movimento de Conteúdo | MÉDIO-ALTO | content- | 5 |
Referência Rápida
1. Física Spring (CRÍTICO)
spring-motion-tokens— Defina tokens de motion como uma enum sem casos para todos os presets de springspring-smooth-default— Padrão para spring .smooth para todas as transições de UIspring-snappy-responsive— Use spring .snappy para interações responsivasspring-bouncy-celebration— Use spring .bouncy para momentos lúdicos e celebratóriosspring-custom-parameters— Ajuste springs personalizados com response e dampingFractionspring-velocity-preservation— Springs preservam velocidade na interrupçãospring-never-linear— Nunca use linear ou easeInOut para UI interativaspring-completion-chaining— Use conclusão com withAnimation para sequências encadeadas
2. Temporização e Sensação (CRÍTICO)
feel-250ms-max— Mantenha animações de UI abaixo de 250msfeel-faster-better— Animações mais rápidas quase sempre parecem melhoresfeel-asymmetric-enter-exit— Use temporização assimétrica para entrada e saídafeel-distance-proportional— Combine a duração com a distância percorridafeel-haptic-sync— Sincronize feedback háptico com keyframes visuais de animaçãofeel-stagger-timing— Escalone revelações em intervalos de 30-50ms
3. Continuidade de Gestos (ALTO)
gesture-rubber-band— Efeito elástico nos limites de arrastogesture-momentum-dismiss— Dispensar no limite de VELOCIDADE OU distânciagesture-snap-points— Use pontos de encaixe conscientes de velocidadegesture-interruptible— Torne todas as animações de gesto interrompíveisgesture-scroll-drag-conflict— Resolva conflitos entre gestos de scroll e arrastogesture-state-transient— Use GestureState para estado de arrasto transitóriogesture-projected-landing— Projete a velocidade do gesto para uma posição de pouso natural
4. Transições Espaciais (ALTO)
spatial-matched-geometry— Use matchedGeometryEffect para morphs de expandir/colapsarspatial-zoom-navigation— Use transição de navegação com zoom para detalhes de coleção (iOS 18)spatial-transition-origin— Ancóre transições ao local do gatilhospatial-hero-shared-element— Compartilhe vários IDs de elemento para animações hero ricasspatial-sheet-morph— Use matchedGeometryEffect para apresentações de sheetspatial-tab-continuity— Mantenha a direção espacial em transições de aba
5. Microinterações (ALTO)
micro-button-press-scale— Escale botões para 0.97 ao pressionar para feedback tátilmicro-haptic-pairing— Emparelhe cada mudança de estado visual com feedback hápticomicro-symbol-effect— Use symbolEffect para animações de SF Symbolmicro-toggle-bounce— Adicione bounce a mudanças de estado de alternânciamicro-long-press-fill— Anime preenchimento progressivo para ações de pressão longamicro-loading-phase— Use spring repetitivo para estados de carregamento orgânicos
6. Orquestração (ALTO)
orch-phase-animator— Use PhaseAnimator para sequências de várias etapasorch-keyframe-animator— Use KeyframeAnimator para movimento preciso na linha do tempoorch-stagger-children— Escalone elementos filhos para revelações orquestradasorch-coordinated-entrance— Coordene entradas de vários elementos com um gatilho compartilhadoorch-timeline-view— Use TimelineView para animações contínuas e repetitivas
7. Artesanato e Polimento (ALTO)
craft-reduce-motion— Respeite accessibilityReduceMotion com fallback de crossfadecraft-blur-bridge— Use blur para preencher estados de transição imperfeitoscraft-drawing-group— Use drawingGroup() para animações complexas com suporte Metalcraft-geometry-group— Use geometryGroup() para isolar a propagação de animação de layoutcraft-transaction-debug— Use Transaction para depurar e substituir o comportamento da animação
8. Movimento de Conteúdo (MÉDIO-ALTO)
content-numeric-text— Use contentTransition(.numericText) para mudanças de númerocontent-scroll-transition— Use scrollTransition para efeitos de posição de scrollcontent-visual-effect— Use visualEffect para animações conscientes de posiçãocontent-symbol-replace— Anime a substituição de símbolos com contentTransitioncontent-text-renderer— Use Text Renderer para animação no nível do caractere (iOS 18)
Como Usar
Leia os arquivos de referência individuais para obter explicações detalhadas com exemplos de código incorretos/corretos:
- Definições de seção — Estrutura de categorias e níveis de impacto
- Modelo de regra — Template para adicionar novas regras
Arquivos de Referência
| Arquivo | Descrição |
|---|---|
| references/_sections.md | Definições de categorias e ordenação |
| assets/templates/_template.md | Template para novas regras |
| metadata.json | Informações de versão e referência |