corrigindo-desempenho-de-movimento
Corrige problemas de desempenho de animações.
como usar
-
/corrigindo-desempenho-de-movimentoAplica estas restrições a qualquer trabalho de animação de UI nesta conversa. -
/corrigindo-desempenho-de-movimento <arquivo>Revisa o arquivo contra todas as regras abaixo e relata:- 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 stack existente.
Quando Usar
Consulte estas diretrizes quando:
- adicionar ou alterar animações de UI (CSS, WAAPI, Motion, rAF, GSAP)
- refatorar interações ou transições com engasgos
- 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 das etapas de renderização
- composição: transform, opacity
- pintura: 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 permitidos | 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 visualização | baixo |
| 9 | limites de ferramenta | crítico |
referência rápida
1. padrões nunca permitidos (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 rolagem
- sem loops 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 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 rebaixar 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 do tipo 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 posição de rolagem para animação
- pause ou pare animações quando fora da tela
- movimento vinculado à rolagem não deve acionar layout contínuo ou pintura em superfícies grandes
5. pintura (médio-alto)
- animação que aciona 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 do compositor requer promoção de camada, nunca presuma
- use will-change temporária e cirurgicamente
- 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 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 UI 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 acionadoras de layout
9. limites de 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 à 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 — 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 permitidos, limites de 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 específica do ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.