corrigiendo-rendimiento-de-movimiento
Arregla problemas de rendimiento en animaciones.
cómo usar
-
/corrigiendo-rendimiento-de-movimientoAplica estas restricciones a cualquier trabajo de animación UI en esta conversación. -
/corrigiendo-rendimiento-de-movimiento <archivo>Revisa el archivo contra todas las reglas a continuación y reporta:- violaciones (cita la línea exacta o fragmento)
- por qué es importante (una frase 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 Usarlo
Consulta estas pautas cuando:
- agregues o cambies animaciones UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorices interacciones o transiciones bruscas
- implementes movimiento vinculado al scroll o revelar al hacer scroll
- animes layout, filtros, máscaras, gradientes o variables CSS
- revises componentes que usan will-change, transformaciones o mediciones
glosario de pasos de renderizado
- composición: transform, opacity
- pintura: 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 permitidos | crítico |
| 2 | elegir el mecanismo | crítico |
| 3 | medición | alto |
| 4 | scroll | 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 nunca permitidos (crítico)
- no intercales lecturas y escrituras de layout en el mismo frame
- no animes layout continuamente 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 combines 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 JS solo cuando la interacción lo requiera
- la animación de pintura o layout es aceptable solo en superficies pequeñas y aisladas
- los efectos de un solo uso 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 opacity
- agrupa todas las lecturas del DOM antes que 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 Scroll o View Timelines para movimiento vinculado al scroll cuando estén disponibles
- usa IntersectionObserver para visibilidad y pausa
- no consultes la posición de scroll para animación
- pausa o detén las animaciones cuando estén fuera de pantalla
- el movimiento vinculado al scroll no debe desencadenar layout o pintura continua en superficies grandes
5. pintura (medio-alto)
- la animación que desencadena pintura solo está permitida en elementos pequeños y aislados
- no animes propiedades pesadas de pintura en contenedores grandes
- no animes variables CSS para transform, opacity o posición
- no animes variables CSS heredadas
- delimita 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 promovidas o demasiado grandes
- valida el comportamiento de las capas con herramientas cuando el rendimiento sea importante
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 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 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 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 nunca permitidos, límites de herramientas)
- elige el trabajo de renderizado menos costoso que coincida con la intención
- para cualquier opció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 antes que teoría
Limitaciones
- Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito arriba.
- No trates el resultado como un sustituto de validación específica del entorno, pruebas o revisión por expertos.
- Detente y pregunta si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.