arreglando-rendimiento-de-movimiento
Arreglar problemas de rendimiento de animaciones.
cómo usar
-
/arreglando-rendimiento-de-movimientoAplica estas restricciones a cualquier trabajo de animación UI en esta conversación. -
/arreglando-rendimiento-de-movimiento <archivo>Revisa el archivo contra todas las reglas a continuación e informa:- violaciones (cita la línea o fragmento exacto)
- por qué es importante (una oración corta)
- una correcció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 Usar
Consulta estas pautas cuando:
- agregues o cambies animaciones UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorices interacciones o transiciones entrecortadas
- implementes movimiento vinculado al scroll o revelar al hacer scroll
- animes layout, filtros, máscaras, degradados o variables CSS
- revises componentes que usen will-change, transformaciones o mediciones
glosario de fases de renderizado
- composite: transform, opacidad
- 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 nunca | crítico |
| 2 | elegir el mecanismo | crítico |
| 3 | medición | alto |
| 4 | scroll | alto |
| 5 | paint | 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 nunca (crítico)
- no intercales lecturas y escrituras de layout en el mismo frame
- no animes layout continuamente en superficies grandes o significativas
- no conduzcas 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 cada uno
2. elegir el mecanismo (crítico)
- por defecto usa transform y opacidad para movimiento
- usa animación controlada 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 de una sola vez son más aceptables que el movimiento continuo
- prefiere degradar la técnica antes que eliminar el movimiento por completo
3. medición (alto)
- mide una vez, luego anima mediante transform o opacidad
- agrupa todas las lecturas del DOM antes de las escrituras
- no leas layout repetidamente durante una animación
- prefiere transiciones estilo FLIP para efectos similares a layout
- prefiere enfoques que agrupen medición y escrituras
4. scroll (alto)
- prefiere Líneas de Tiempo de Scroll o Vista para movimiento vinculado al scroll cuando estén disponibles
- usa IntersectionObserver para visibilidad y pausa
- no sondees la posición de scroll para animación
- pausa o detén animaciones cuando estén fuera de la pantalla
- el movimiento vinculado al scroll no debe desencadenar layout o paint continuos en superficies grandes
5. paint (medio-alto)
- la animación que desencadena paint solo está permitida en elementos pequeños y aislados
- no animes propiedades pesadas de paint en contenedores grandes
- no animes variables CSS para transform, opacidad o posición
- no animes variables CSS heredadas
- limita las variables CSS animadas al ámbito local y evita la herencia
6. capas (medio)
- el movimiento del compositor requiere promoción de capa, nunca lo asumas
- usa will-change de manera temporal y quirúrgica
- evita muchas capas promovidas o capas grandes
- valida el comportamiento de 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 de una sola vez
- nunca animes desenfoque continuamente
- nunca animes desenfoque en superficies grandes
- prefiere opacidad 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 muchas interacciones
- evita transiciones de vista cuando se requiera interrupción o cancelación
- trata los cambios de tamaño como potencialmente desencadenantes 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 al 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 nunca, 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 prácticas y alternativas concretas sobre teoría
Limitaciones
- Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates el resultado como un sustituto de la validación específica del entorno, las pruebas o la revisión de expertos.
- Detente y pide aclaración si faltan las entradas requeridas, los permisos, los límites de seguridad o los criterios de éxito.