correction-performance-mouvement
Corrigez les problèmes de performance d'animation.
comment utiliser
-
/correction-performance-mouvementAppliquez ces contraintes à tout travail d'animation UI dans cette conversation. -
/correction-performance-mouvement <fichier>Examinez le fichier par rapport à toutes les règles ci-dessous et signalez :- les violations (citez la ligne ou l'extrait exact)
- pourquoi c'est important (une phrase courte)
- une correction concrète (suggestion au niveau du code)
Ne migrez pas les bibliothèques d'animation sauf demande explicite. Appliquez les règles dans la pile existante.
quand appliquer
Référez-vous à ces directives lorsque :
- vous ajoutez ou modifiez des animations UI (CSS, WAAPI, Motion, rAF, GSAP)
- vous remaniez des interactions ou transitions saccadées
- vous implémentez un mouvement lié au défilement ou un dévoilement au défilement
- vous animez le layout, les filtres, les masques, les dégradés ou les variables CSS
- vous examinez des composants qui utilisent
will-change, les transformations ou les mesures
glossaire des étapes de rendu
- composite :
transform,opacity - peinture : couleur, bordures, dégradés, masques, images, filtres
- layout : taille, position, flux, grille, flex
catégories de règles par priorité
| priorité | catégorie | impact |
|---|---|---|
| 1 | patterns jamais | critique |
| 2 | choisir le mécanisme | critique |
| 3 | mesure | élevé |
| 4 | défilement | élevé |
| 5 | peinture | moyen-élevé |
| 6 | couches | moyen |
| 7 | flou et filtres | moyen |
| 8 | transitions de vue | faible |
| 9 | limites des outils | critique |
référence rapide
1. patterns jamais (critique)
- n'entrelacez pas les lectures et écritures de layout dans la même frame
- n'animez pas le layout en continu sur des surfaces grandes ou significatives
- ne pilotez pas l'animation à partir de
scrollTop,scrollYou des événements de défilement - pas de boucles
requestAnimationFramesans condition d'arrêt - ne mélangez pas plusieurs systèmes d'animation qui mesurent ou modifient le layout
2. choisir le mécanisme (critique)
- privilégiez par défaut
transformetopacitypour le mouvement - utilisez l'animation pilotée par JS uniquement lorsque l'interaction l'exige
- l'animation de peinture ou de layout n'est acceptable que sur des surfaces petites et isolées
- les effets ponctuels sont plus acceptables que le mouvement continu
- préférez rétrograder la technique plutôt que de supprimer entièrement le mouvement
3. mesure (élevé)
- mesurez une fois, puis animez via
transformouopacity - regroupez toutes les lectures DOM avant les écritures
- ne lisez pas le layout de manière répétée pendant une animation
- préférez les transitions de style FLIP pour les effets de layout
- préférez les approches qui regroupent la mesure et les écritures
4. défilement (élevé)
- préférez les chronologies de défilement ou de vue pour le mouvement lié au défilement lorsqu'elles sont disponibles
- utilisez
IntersectionObserverpour la visibilité et la pause - ne sondez pas la position de défilement pour l'animation
- mettez en pause ou arrêtez les animations lorsqu'elles sont hors écran
- le mouvement lié au défilement ne doit pas déclencher de layout ou de peinture continue sur de grandes surfaces
5. peinture (moyen-élevé)
- l'animation déclenchant la peinture n'est autorisée que sur des éléments petits et isolés
- n'animez pas les propriétés lourdes en peinture sur de grands conteneurs
- n'animez pas les variables CSS pour
transform,opacityou la position - n'animez pas les variables CSS héritées
- limitez les variables CSS animées localement et évitez l'héritage
6. couches (moyen)
- le mouvement du compositeur nécessite la promotion de couche, ne la tenez jamais pour acquise
- utilisez
will-changede manière temporaire et chirurgicale - évitez de nombreuses ou grandes couches promues
- validez le comportement des couches avec des outils lorsque la performance est importante
7. flou et filtres (moyen)
- gardez l'animation de flou petite (<= 8px)
- utilisez le flou uniquement pour des effets courts et ponctuels
- n'animez jamais le flou en continu
- n'animez jamais le flou sur de grandes surfaces
- préférez
opacityettranslateavant le flou
8. transitions de vue (faible)
- utilisez les transitions de vue uniquement pour les changements au niveau de la navigation
- évitez les transitions de vue pour les UI riches en interactions
- évitez les transitions de vue lorsque l'interruption ou l'annulation est nécessaire
- traitez les changements de taille comme potentiellement déclencheurs de layout
9. limites des outils (critique)
- ne migrez ni ne réécrivez les bibliothèques d'animation sauf demande explicite
- appliquez ces règles dans le système d'animation existant
- ne migrez jamais partiellement les API et ne mélangez pas les styles au sein du même composant
corrections courantes
/* thrashing de layout : animez transform au lieu de width */
/* avant */ .panneau { transition: width 0.3s; }
/* après */ .panneau { transition: transform 0.3s; }
/* lié au défilement : utilisez scroll-timeline au lieu de JS */
/* avant */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* après */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// mesure : regroupez les lectures avant les écritures (FLIP)
// avant — thrashing de layout
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// après — mesurez une fois, animez via transform
const premier = el.getBoundingClientRect();
el.classList.add('deplace');
const dernier = el.getBoundingClientRect();
el.style.transform = `translateX(${premier.left - dernier.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
directives de révision
- appliquez en priorité les règles critiques (patterns jamais, limites des outils)
- choisissez le travail de rendu le moins coûteux qui correspond à l'intention
- pour tout choix non par défaut, indiquez la contrainte qui le justifie (taille de surface, durée ou exigence d'interaction)
- lors de la révision, privilégiez les notes actionnables et les alternatives concrètes plutôt que la théorie