corrección-rendimiento-movimiento
Corrige problemas de rendimiento en animaciones.
cómo usar
-
/corrección-rendimiento-movimientoAplica estas restricciones a cualquier trabajo de animación de UI en esta conversación. -
/corrección-rendimiento-movimiento <archivo>Revisa el archivo según todas las reglas a continuación e informa:- violaciones (cita la línea exacta o fragmento)
- por qué es importante (una frase corta)
- una solución concreta (sugerencia a nivel de código)
No migres librerías de animación a menos que se solicite explícitamente. Aplica las reglas dentro del stack existente.
cuándo aplicar
Consulta estas pautas cuando:
- agregues o modifiques animaciones de UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorices interacciones o transiciones defectuosas
- implementes movimiento vinculado al desplazamiento o revelación al desplazarse
- animes layout, filtros, máscaras, degradados o variables CSS
- revises componentes que usan will-change, transformaciones o mediciones
glosario de pasos de renderizado
- composite: transform, opacity
- paint: color, bordes, degradados, máscaras, imágenes, filtros
- layout: tamaño, posición, flujo, grid, flex
categorías de reglas por prioridad
| prioridad | categoría | impacto |
|---|---|---|
| 1 | patrones que nunca se deben usar | crítico |
| 2 | elegir el mecanismo | crítico |
| 3 | medición | alto |
| 4 | desplazamiento | alto |
| 5 | pintura | medio-alto |
| 6 | capas | medio |
| 7 | desenfoque y filtros | medio |
| 8 | transiciones de vista | bajo |
| 9 | límites de herramientas | crítico |
referencia rápida
1. patrones que nunca se deben usar (crítico)
- no intercales lecturas y escrituras de layout en el mismo frame
- no animes layout de forma continua en superficies grandes o significativas
- no impulses animaciones desde scrollTop, scrollY o eventos de scroll
- no uses bucles requestAnimationFrame sin una condición de parada
- no mezcles múltiples sistemas de animación que midan o muten layout
2. elegir el mecanismo (crítico)
- usa por defecto transform y opacity para el movimiento
- usa animación impulsada por JS solo cuando la interacción lo requiera
- la animación de paint o layout es aceptable solo en superficies pequeñas y aisladas
- los efectos únicos son más aceptables que el movimiento continuo
- prefiere degradar la técnica en lugar de eliminar el movimiento por completo
3. medición (alto)
- mide una vez, luego anima mediante transform u opacity
- agrupa todas las lecturas del DOM antes de las escrituras
- no leas el layout repetidamente durante una animación
- prefiere transiciones de estilo FLIP para efectos similares a layout
- prefiere enfoques que agrupen medición y escrituras
4. desplazamiento (alto)
- prefiere Scroll o View Timelines para movimiento vinculado al desplazamiento cuando estén disponibles
- usa IntersectionObserver para visibilidad y pausa
- no consultes la posición de desplazamiento para animación
- pausa o detén las animaciones cuando estén fuera de pantalla
- el movimiento vinculado al desplazamiento no debe activar layout o paint continuo en superficies grandes
5. pintura (medio-alto)
- la animación que activa paint solo está permitida en elementos pequeños y aislados
- no animes propiedades que activan paint en contenedores grandes
- no animes variables CSS para transform, opacity o posición
- no animes variables CSS heredadas
- limita las variables CSS animadas localmente y evita la herencia
6. capas (medio)
- el movimiento del compositor requiere promoción de capa, nunca lo des por sentado
- usa will-change de forma temporal y quirúrgica
- evita muchas capas promocionadas o grandes
- valida el comportamiento de las capas con herramientas cuando el rendimiento importe
7. desenfoque y filtros (medio)
- mantén la animación de desenfoque pequeña (<=8px)
- usa desenfoque solo para efectos cortos y únicos
- nunca animes desenfoque de forma continua
- nunca animes desenfoque en superficies grandes
- prefiere opacity y translate antes que desenfoque
8. transiciones de vista (bajo)
- usa transiciones de vista solo para cambios a nivel de navegación
- evita transiciones de vista para UI con mucha interacción
- evita transiciones de vista cuando se requiera interrupción o cancelación
- trata los cambios de tamaño como potencialmente activadores de layout
9. límites de herramientas (crítico)
- no migres ni reescribas librerías de animación a menos que se solicite explícitamente
- aplica estas reglas dentro del sistema de animación existente
- nunca migres APIs parcialmente ni mezcles estilos dentro del mismo componente
correcciones comunes
/* thrashing de layout: anima transform en lugar de width */
/* antes */ .panel { transition: width 0.3s; }
/* después */ .panel { transition: transform 0.3s; }
/* vinculado a scroll: usa scroll-timeline en lugar de JS */
/* antes */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* después */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// medición: agrupa lecturas antes de escrituras (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// después — mide una vez, anima mediante transform
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
guía de revisión
- aplica primero las reglas críticas (patrones que nunca se deben usar, límites de herramientas)
- elige el trabajo de renderizado menos costoso que coincida con la intención
- para cualquier elección no predeterminada, indica la restricción que la justifica (tamaño de superficie, duración o requisito de interacción)
- al revisar, prefiere notas accionables y alternativas concretas en lugar de teoría