corrección-de-rendimiento-de-animaciones
Soluciona problemas de rendimiento en animaciones.
cómo usar
-
/corrección-de-rendimiento-de-animacionesAplica estas restricciones a cualquier trabajo de animación de UI en esta conversación. -
/corrección-de-rendimiento-de-animaciones <archivo>Revisa el archivo según todas las reglas a continuación e informa:- infracciones (cita la línea o fragmento exacto)
- 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 cambies animaciones de UI (CSS, WAAPI, Motion, rAF, GSAP)
- refactorices interacciones o transiciones lentas
- implementes movimiento vinculado al desplazamiento o revelar al desplazar
- animes diseño (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 (paint): color, bordes, degradados, máscaras, imágenes, filtros
- diseño (layout): tamaño, posición, flujo, grid, flex
categorías de reglas por prioridad
| prioridad | categoría | impacto |
|---|---|---|
| 1 | patrones que nunca usar | crítico |
| 2 | elegir el mecanismo | crítico |
| 3 | medición | alto |
| 4 | desplazamiento (scroll) | alto |
| 5 | pintura | medio-alto |
| 6 | capas | medio |
| 7 | desenfoque y filtros | medio |
| 8 | transiciones de vista | bajo |
| 9 | límites de herramienta | crítico |
referencia rápida
1. patrones que nunca usar (crítico)
- no intercales lecturas y escrituras de diseño en el mismo frame
- no animes diseño 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 mezcles múltiples sistemas de animación que midan o muten diseño
2. elegir el mecanismo (crítico)
- usa por defecto transform y opacity para movimiento
- usa animación controlada por JS solo cuando la interacción lo requiera
- la animación de pintura o diseño es aceptable solo en superficies pequeñas y aisladas
- los efectos únicos son aceptables con más frecuencia 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 o opacity
- agrupa todas las lecturas del DOM antes de las escrituras
- no leas diseño repetidamente durante una animación
- prefiere transiciones estilo FLIP para efectos similares a diseño
- 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 animaciones
- pausa o detén animaciones cuando estén fuera de pantalla
- el movimiento vinculado al desplazamiento no debe desencadenar diseño o pintura continuos 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 costosas de pintura 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 sea importante
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 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 mucha interacción
- evita transiciones de vista cuando se requiera interrupción o cancelación
- trata los cambios de tamaño como potencialmente desencadenantes de diseño
9. límites de herramienta (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
guía de revisión
- aplica primero las reglas críticas (patrones que nunca usar, límites de herramienta)
- 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