reparación-rendimiento-movimiento
Corregir problemas de rendimiento en animaciones.
cómo usar
-
/reparación-rendimiento-movimientoAplica estas restricciones a cualquier trabajo de animación de UI en esta conversación. -
/reparación-rendimiento-movimiento <archivo>Revisa el archivo contra todas las reglas a continuación e informa:- violaciones (cita la línea exacta o el fragmento)
- por qué importa (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 de UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorices interacciones o transiciones bruscas
- implementes movimiento vinculado al scroll o revelación al hacer scroll
- animes layout, filtros, máscaras, degradados o variables CSS
- revises componentes que usen 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 prohibidos | 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 la herramienta | crítico |
referencia rápida
1. patrones prohibidos (crítico)
- no intercalar lecturas y escrituras de layout en el mismo frame
- no animar layout continuamente en superficies grandes o significativas
- no impulsar animaciones desde scrollTop, scrollY o eventos de scroll
- no usar bucles requestAnimationFrame sin una condición de parada
- no mezclar múltiples sistemas de animación que midan o muten el layout
2. elegir el mecanismo (crítico)
- usar por defecto transform y opacity para movimiento
- usar animación impulsada por 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 una sola vez son aceptables más a menudo que el movimiento continuo
- preferir degradar la técnica antes que eliminar el movimiento por completo
3. medición (alto)
- medir una vez, luego animar mediante transform u opacity
- agrupar todas las lecturas del DOM antes de las escrituras
- no leer layout repetidamente durante una animación
- preferir transiciones estilo FLIP para efectos similares a layout
- preferir enfoques que agrupen medición y escrituras
4. scroll (alto)
- preferir Scroll o View Timelines para movimiento vinculado al scroll cuando estén disponibles
- usar IntersectionObserver para visibilidad y pausa
- no sondear la posición de scroll para animación
- pausar o detener animaciones cuando estén fuera de pantalla
- el movimiento vinculado al scroll no debe provocar 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 animar propiedades pesadas de pintura en contenedores grandes
- no animar variables CSS para transform, opacity o posición
- no animar variables CSS heredadas
- limitar el ámbito de las variables CSS animadas localmente y evitar la herencia
6. capas (medio)
- el movimiento del compositor requiere promoción de capa, nunca asumirlo
- usar will-change de forma temporal y quirúrgica
- evitar muchas o grandes capas promovidas
- validar el comportamiento de capas con herramientas cuando el rendimiento importe
7. desenfoque y filtros (medio)
- mantener la animación de desenfoque pequeña (<=8px)
- usar desenfoque solo para efectos cortos y de una sola vez
- nunca animar desenfoque continuamente
- nunca animar desenfoque en superficies grandes
- preferir opacity y translate antes que desenfoque
8. transiciones de vista (bajo)
- usar transiciones de vista solo para cambios a nivel de navegación
- evitar transiciones de vista en UI con mucha interacción
- evitar transiciones de vista cuando se requiera interrupción o cancelación
- tratar los cambios de tamaño como potencialmente desencadenantes de layout
9. límites de la herramienta (crítico)
- no migrar ni reescribir librerías de animación a menos que se solicite explícitamente
- aplicar estas reglas dentro del sistema de animación existente
- nunca migrar APIs parcialmente ni mezclar estilos dentro del mismo componente
correcciones comunes
/* thrashing de layout: animar transform en lugar de width */
/* antes */ .panel { transition: width 0.3s; }
/* después */ .panel { transition: transform 0.3s; }
/* vinculado al scroll: usar 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: agrupar lecturas antes de escrituras (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// después — medir una vez, animar 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
- aplicar primero las reglas críticas (patrones prohibidos, límites de la herramienta)
- elegir el trabajo de renderizado menos costoso que coincida con la intención
- para cualquier elección no predeterminada, indicar la restricción que la justifica (tamaño de superficie, duración o requisito de interacción)
- al revisar, preferir notas accionables y alternativas concretas sobre teoría
Conexiones
- Dominio: [[Diseño y Creatividad]]
- Categoría: [[3D y Animación]]
- Navegación: [[Resumen de Skills]], [[Inicio]]