Correção de Desempenho de Animação (fixing-motion-performance)
Regra de Leitura Seletiva
Comece com:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Em seguida, carregue apenas os documentos herdados, scripts, assets ou exemplos que correspondam à tarefa real do usuário.
Corrigir problemas de desempenho de animação.
Como usar
-
/fixing-motion-performanceAplique estas restrições a qualquer trabalho de animação de interface nesta conversa. -
/fixing-motion-performance <arquivo>Revise o arquivo em relação a todas as regras abaixo e relate:- violações (cite a linha ou trecho exato)
- por que é importante (uma frase curta)
- uma correção concreta (sugestão em nível de código)
Não migre bibliotecas de animação, a menos que explicitamente solicitado. Aplique as regras dentro do stack existente.
Quando usar
Consulte estas diretrizes ao:
- adicionar ou alterar animações de IU (CSS, WAAPI, Motion, rAF, GSAP)
- refatorar interações ou transições instáveis
- implementar movimento vinculado a scroll ou revelar ao scroll
- animar layout, filtros, máscaras, gradientes ou variáveis CSS
- revisar componentes que usam will-change, transformações ou medições
Glossário de etapas de renderização
- composite: transform, opacity
- paint: color, borders, gradients, masks, images, filters
- layout: size, position, flow, grid, flex
Categorias de regras por prioridade
| prioridade | categoria | impacto |
|---|---|---|
| 1 | nunca padrões | crítico |
| 2 | escolher o mecanismo | crítico |
| 3 | medição | alto |
| 4 | scroll | alto |
| 5 | paint | médio-alto |
| 6 | camadas | médio |
| 7 | desfoque e filtros | médio |
| 8 | transições de visualização | baixo |
| 9 | limites da ferramenta | crítico |
Referência rápida
1. Nunca padrões (crítico)
- não intercale leituras e escritas de layout no mesmo frame
- não anime layout continuamente em superfícies grandes ou significativas
- não conduza animação a partir de scrollTop, scrollY ou eventos de scroll
- sem loops requestAnimationFrame sem condição de parada
- não misture múltiplos sistemas de animação que cada um meça ou mude layout
2. Escolher o mecanismo (crítico)
- use transform e opacity por padrão para movimento
- use animação via JS apenas quando a interação exigir
- animação de paint ou layout é aceitável apenas em superfícies pequenas e isoladas
- efeitos únicos são mais aceitáveis do que movimento contínuo
- prefira degradar a técnica a remover o movimento completamente
3. Medição (alto)
- meça uma vez, depois anime via transform ou opacity
- agrupe todas as leituras de DOM antes das escritas
- não leia layout repetidamente durante uma animação
- prefira transições estilo FLIP para efeitos semelhantes a layout
- prefira abordagens que agrupem medição e escritas
4. Scroll (alto)
- prefira Scroll ou View Timelines para movimento vinculado a scroll quando disponível
- use IntersectionObserver para visibilidade e pausa
- não consulte posição do scroll para animação
- pause ou pare animações quando fora da tela
- movimento vinculado a scroll não deve disparar layout ou paint contínuos em superfícies grandes
5. Paint (médio-alto)
- animação que dispara paint é permitida apenas em elementos pequenos e isolados
- não anime propriedades pesadas de paint em contêineres grandes
- não anime variáveis CSS para transform, opacity ou position
- não anime variáveis CSS herdadas
- limite variáveis CSS animadas localmente e evite herança
6. Camadas (médio)
- movimento do compositor requer promoção de camada, nunca assuma isso
- use will-change de forma temporária e cirúrgica
- evite muitas camadas promovidas ou grandes
- valide o comportamento das camadas com ferramentas quando o desempenho for importante
7. Desfoque e filtros (médio)
- mantenha a animação de desfoque pequena (<=8px)
- use desfoque apenas para efeitos curtos e únicos
- nunca anime desfoque continuamente
- nunca anime desfoque em superfícies grandes
- prefira opacity e translate antes de desfoque
8. Transições de visualização (baixo)
- use transições de visualização apenas para mudanças em nível de navegação
- evite transições de visualização para IU com muitas interações
- evite transições de visualização quando interrupção ou cancelamento for necessário
- trate mudanças de tamanho como potencialmente disparadoras de layout
9. Limites da ferramenta (crítico)
- não migre ou reescreva bibliotecas de animação a menos que explicitamente solicitado
- aplique estas regras dentro do sistema de animação existente
- nunca migre APIs parcialmente ou misture estilos dentro do mesmo componente
Correções comuns
/* thrashing de layout: anime transform em vez de width */
/* antes */ .painel { transition: width 0.3s; }
/* depois */ .painel { transition: transform 0.3s; }
/* vinculado a scroll: use scroll-timeline em vez de JS */
/* antes */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* depois */ .revelar { animation: fade-in linear; animation-timeline: view(); }
// medição: agrupe leituras antes das escritas (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// depois — meça uma vez, anime via transform
const primeiro = el.getBoundingClientRect();
el.classList.add('moveu');
const ultimo = el.getBoundingClientRect();
el.style.transform = `translateX(${primeiro.left - ultimo.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
Guia de revisão
- aplique regras críticas primeiro (nunca padrões, limites da ferramenta)
- escolha o trabalho de renderização menos custoso que corresponda à intenção
- para qualquer escolha não padrão, indique a restrição que a justifica (tamanho da superfície, duração ou requisito de interação)
- ao revisar, prefira notas acionáveis e alternativas concretas em vez de teoria
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação, teste ou revisão de especialistas específica do ambiente.
- Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.