corrigindo-performance-de-movimento
Corrija problemas de performance de animação.
como usar
-
/corrigindo-performance-de-movimentoAplique estas restrições a qualquer trabalho de animação de UI nesta conversa. -
/corrigindo-performance-de-movimento <arquivo>Revise o arquivo contra todas as regras abaixo e relate:- violações (cite a linha exata ou trecho)
- por que isso importa (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 existente.
quando aplicar
Consulte estas diretrizes quando:
- adicionar ou alterar animações de UI (CSS, WAAPI, Motion, rAF, GSAP)
- refatorar interações ou transições com travamentos
- implementar movimento vinculado à rolagem ou revelar ao rolar
- 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 | padrões-nunca | crítico |
| 2 | escolha o mecanismo | crítico |
| 3 | medição | alto |
| 4 | rolagem | alto |
| 5 | pintura | médio-alto |
| 6 | camadas | médio |
| 7 | desfoque e filtros | médio |
| 8 | transições de visão | baixo |
| 9 | limites de ferramentas | crítico |
referência rápida
1. padrões-nunca (crítico)
- não intercale leituras e escritas de layout no mesmo quadro
- 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 de requestAnimationFrame sem condição de parada
- não misture múltiplos sistemas de animação que cada um meça ou mude o layout
2. escolha o mecanismo (crítico)
- prefira transform e opacity para movimento
- use animação orientada por 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 aceitáveis com mais frequência do que movimento contínuo
- prefira rebaixar 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 do 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. rolagem (alto)
- prefira Scroll ou View Timelines para movimento vinculado à rolagem quando disponível
- use IntersectionObserver para visibilidade e pausa
- não consulte a posição de rolagem para animação
- pause ou pare animações quando estiver fora da tela
- movimento vinculado à rolagem não deve desencadear layout contínuo ou pintura em superfícies grandes
5. pintura (médio-alto)
- animação que desencadeia 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 no compositor requer promoção de camada, nunca assuma que acontece
- use will-change temporária e cirurgicamente
- evite muitas ou grandes camadas promovidas
- valide o comportamento da camada com ferramentas quando a performance importar
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 visão (baixo)
- use transições de visão apenas para mudanças no nível de navegação
- evite transições de visão para UI com muita interação
- evite transições de visão quando interrupção ou cancelamento for necessário
- trate mudanças de tamanho como potencialmente desencadeadoras de layout
9. limites de ferramentas (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 à rolagem: 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 first = el.getBoundingClientRect();
el.classList.add('movido');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.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 de ferramentas)
- escolha o trabalho de renderização menos custoso que corresponda à intenção
- para qualquer escolha não padrão, declare 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