Corrección de Rendimiento en Movimiento
Regla de Lectura Selectiva
Comience con:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
A continuación, cargue únicamente los documentos, scripts, activos o ejemplos heredados que coincidan con la tarea real del usuario.
Corrija problemas de rendimiento en animaciones.
Cómo Usar
-
/fixing-motion-performanceAplique estas restricciones a cualquier trabajo de animación UI en esta conversación. -
/fixing-motion-performance <archivo>Revise el archivo con todas las reglas a continuación e informe:- violaciones (cite la línea o fragmento exacto)
- por qué es importante (una frase breve)
- una corrección concreta (sugerencia a nivel de código)
No migre bibliotecas de animación a menos que se solicite explícitamente. Aplique las reglas dentro del stack existente.
Cuándo Usar
Consulte estas pautas cuando:
- agregue o modifique animaciones UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorice interacciones o transiciones entrecortadas
- implemente movimiento vinculado al scroll o revelado al hacer scroll
- anime layout, filtros, máscaras, degradados o variables CSS
- revise componentes que usen 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 a evitar nunca | 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 a Evitar Nunca (crítico)
- No intercale lecturas y escrituras de layout en el mismo frame
- No anime el layout continuamente en superficies grandes o significativas
- No impulse animaciones desde scrollTop, scrollY o eventos de scroll
- No haya bucles de requestAnimationFrame sin una condición de parada
- No mezcle múltiples sistemas de animación que midan o muten el layout
2. Elegir el Mecanismo (crítico)
- Use transform y opacity como valores predeterminados para la animación
- Use 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 de una sola vez son más aceptables que el movimiento continuo
- Prefiera degradar la técnica antes que eliminar el movimiento por completo
3. Medición (alto)
- Mida una vez, luego anime mediante transform u opacity
- Agrupe todas las lecturas del DOM antes de las escrituras
- No lea el layout repetidamente durante una animación
- Prefiera transiciones de estilo FLIP para efectos similares a layout
- Prefiera enfoques que agrupen medición y escrituras
4. Scroll (alto)
- Prefiera Scroll Timelines o View Timelines para el movimiento vinculado al scroll cuando estén disponibles
- Use IntersectionObserver para visibilidad y pausa
- No consulte la posición del scroll para la animación
- Pause o detenga 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 paint solo está permitida en elementos pequeños y aislados
- No anime propiedades pesadas de paint en contenedores grandes
- No anime variables CSS para transform, opacity o posición
- No anime variables CSS heredadas
- Limite las variables CSS animadas localmente y evite la herencia
6. Capas (medio)
- El movimiento del compositor requiere promoción de capa, nunca lo dé por sentado
- Use will-change de manera temporal y quirúrgica
- Evite muchas capas promovidas o grandes
- Valide el comportamiento de capas con herramientas cuando el rendimiento sea importante
7. Desenfoque y Filtros (medio)
- Mantenga la animación de desenfoque pequeña (<=8px)
- Use desenfoque solo para efectos cortos y de una sola vez
- Nunca anime el desenfoque continuamente
- Nunca anime el desenfoque en superficies grandes
- Prefiera opacity y translate antes que desenfoque
8. Transiciones de Vista (bajo)
- Use transiciones de vista solo para cambios a nivel de navegación
- Evite transiciones de vista para UI con muchas interacciones
- Evite transiciones de vista cuando se requiera interrupción o cancelación
- Trate los cambios de tamaño como potencialmente desencadenantes de layout
9. Límites de Herramientas (crítico)
- No migre ni reescriba bibliotecas de animación a menos que se solicite explícitamente
- Aplique estas reglas dentro del sistema de animación existente
- Nunca migre APIs parcialmente ni mezcle estilos dentro del mismo componente
Correcciones Comunes
/* thrashing de layout: anime transform en lugar de width */
/* antes */ .panel { transition: width 0.3s; }
/* después */ .panel { transition: transform 0.3s; }
/* vinculado al scroll: use 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: agrupe lecturas antes de escrituras (FLIP)
// antes — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// después — mida una vez, anime 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
- Aplique primero las reglas críticas (patrones a evitar nunca, límites de herramientas)
- Elija el trabajo de renderizado menos costoso que coincida con la intención
- Para cualquier elección no predeterminada, indique la restricción que la justifique (tamaño de superficie, duración o requisito de interacción)
- Al revisar, prefiera notas accionables y alternativas concretas sobre teoría
Limitaciones
- Use esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trate el resultado como un sustituto de la validación específica del entorno, pruebas o revisión experta.
- Deténgase y solicite aclaración si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.