consertando-desempenho-de-movimento
Corrige problemas de desempenho de animações.
como usar
-
/consertando-desempenho-de-movimentoAplica estas restrições a qualquer trabalho de animação de interface nesta conversa. -
/consertando-desempenho-de-movimento <arquivo>Revisa o arquivo com base em todas as regras abaixo e relata:- 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 da pilha tecnológica existente.
Quando usar
Consulte estas diretrizes quando:
- adicionar ou alterar animações de interface (CSS, WAAPI, Motion, rAF, GSAP)
- refatorar interações ou transições com engasgos
- 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ção
glossário das etapas de renderização
- compor: transform, opacity
- pintar: cor, bordas, gradientes, máscaras, imagens, filtros
- layout: tamanho, posição, fluxo, grid, flex
categorias de regras por prioridade
| prioridade | categoria | impacto |
|---|---|---|
| 1 | padrões nunca | crítico |
| 2 | escolher o mecanismo | crítico |
| 3 | medição | alto |
| 4 | scroll | alto |
| 5 | pintura | 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. padrões nunca (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 acione animação a partir de scrollTop, scrollY ou eventos de scroll
- nenhum loop 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)
- padrão para transform e opacity para movimento
- use animação com JS apenas quando a interação exigir
- animação de pintura 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 em vez de 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 de scroll para animação
- pause ou pare animações quando fora da tela
- movimento vinculado a scroll não deve acionar layout contínuo ou pintura em superfícies grandes
5. pintura (médio-alto)
- animação que dispara pintura é permitida apenas em elementos pequenos e isolados
- não anime propriedades pesadas de pintura em contêineres grandes
- não anime variáveis CSS para transform, opacity ou posição
- não anime variáveis CSS herdadas
- escopo de variáveis CSS animadas localmente e evite herança
6. camadas (médio)
- movimento por compositor requer promoção de camada, nunca assuma
- use will-change temporária e cirurgicamente
- evite muitas camadas promovidas ou grandes
- valide o comportamento das camadas com ferramentas quando a performance importar
7. desfoque e filtros (médio)
- mantenha 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 no nível de navegação
- evite transições de visualização para interfaces com muita interação
- 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
/* layout thrashing: 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 — layout thrash
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// depois — meça uma vez, anime via transform
const primeiro = el.getBoundingClientRect();
el.classList.add('movido');
const ultimo = el.getBoundingClientRect();
el.style.transform = `translateX(${primeiro.left - ultimo.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
orientação de revisão
- aplique regras críticas primeiro (padrões nunca, limites da ferramenta)
- escolha o trabalho de renderização menos custoso que atenda à 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