Que fait fixing-motion-performance ?
Résout les problèmes de performance des animations UI.
comment l'utiliser
-
/fixing-motion-performanceApplique ces contraintes à toute animation UI de cette conversation. -
/fixing-motion-performance <fichier>Examine le fichier selon toutes les règles ci-dessous et rapporte :- les violations (citer la ligne ou l'extrait exact)
- pourquoi c'est important (une phrase courte)
- une correction concrète (suggestion au niveau du code)
Ne pas migrer de bibliothèques d'animation sauf demande explicite. Appliquer les règles dans la stack existante.
quand appliquer
Référez-vous à ces directives quand :
- vous ajoutez ou modifiez des animations UI (CSS, WAAPI, Motion, rAF, GSAP)
- vous refactorez des interactions ou transitions saccadées
- vous implémentez des animations liées au défilement ou des révélations au scroll
- vous animez la mise en page, les filtres, les masques, les dégradés ou les variables CSS
- vous révisez des composants utilisant
will-change, les transformations ou les mesures
glossaire des étapes de rendu
- composite :
transform,opacity - peinture : couleur, bordures, dégradés, masques, images, filtres
- mise en page : taille, position, flux, grille, flex
catégories de règles par priorité
| priorité | catégorie | impact |
|---|---|---|
| 1 | patterns à ne jamais utiliser | critique |
| 2 | choix du 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 à ne jamais utiliser (critique)
- ne pas entrelacer les lectures et écritures de mise en page dans la même trame
- ne pas animer la mise en page en continu sur des surfaces grandes ou significatives
- ne pas piloter l'animation depuis
scrollTop,scrollYou les événementsscroll - pas de boucles
requestAnimationFramesans condition d'arrêt - ne pas mélanger plusieurs systèmes d'animation qui mesurent ou modifient la mise en page
2. choix du mécanisme (critique)
- par défaut, utiliser
transformetopacitypour le mouvement - utiliser l'animation pilotée par JavaScript uniquement lorsque l'interaction l'exige
- l'animation de peinture ou de mise en page est acceptable uniquement sur des petites surfaces isolées
- les effets ponctuels sont plus souvent acceptables que le mouvement continu
- préférer une technique de niveau inférieur plutôt que de supprimer complètement l'animation
3. mesure (élevé)
- mesurer une fois, puis animer via
transformouopacity - regrouper toutes les lectures du DOM avant les écritures
- ne pas lire la mise en page de manière répétée pendant une animation
- préférer les transitions de type FLIP pour les effets de mise en page
- préférer les approches qui regroupent les mesures et les écritures
4. défilement (élevé)
- préférer les timelines
ScrollouViewpour le mouvement lié au défilement quand elles sont disponibles - utiliser
IntersectionObserverpour la visibilité et la mise en pause - ne pas interroger la position de défilement pour l'animation
- mettre en pause ou arrêter les animations quand l'élément est hors écran
- le mouvement lié au défilement ne doit pas déclencher de mise en page ou de peinture continue sur de grandes surfaces
5. peinture (moyen-élevé)
- l'animation déclenchant de la peinture n'est autorisée que sur des petits éléments isolés
- ne pas animer de propriétés lourdes en peinture sur de grands conteneurs
- ne pas animer de variables CSS pour
transform,opacityouposition - ne pas animer de variables CSS héritées
- limiter les variables CSS animées localement et éviter l'héritage
6. couches (moyen)
- le mouvement du compositeur nécessite une promotion de couche, ne jamais la supposer
- utiliser
will-changede manière temporaire et chirurgicale - éviter un grand nombre de couches promues ou de grandes couches
- valider le comportement des couches avec des outils quand la performance compte
7. flou et filtres (moyen)
- garder l'animation de flou petite (<=8px)
- utiliser le flou uniquement pour des effets courts et ponctuels
- ne jamais animer le flou en continu
- ne jamais animer le flou sur de grandes surfaces
- préférer
opacityettranslateau flou
8. transitions de vue (faible)
- utiliser les transitions de vue uniquement pour les changements de navigation
- éviter les transitions de vue pour les UI fortement interactives
- éviter les transitions de vue quand une interruption ou une annulation est nécessaire
- traiter les changements de taille comme potentiellement déclencheurs de mise en page
9. limites des outils (critique)
- ne pas migrer ou réécrire de bibliothèques d'animation sauf demande explicite
- appliquer ces règles dans le système d'animation existant
- ne jamais migrer partiellement des API ou mélanger les styles dans le même composant
guide de révision
- appliquer d'abord les règles critiques (patterns à ne jamais utiliser, limites des outils)
- choisir le travail de rendu le moins coûteux qui correspond à l'intention
- pour tout choix non par défaut, indiquer la contrainte qui le justifie (taille de surface, durée ou besoin d'interaction)
- lors de la révision, privilégier les notes actionnables et les alternatives concrètes plutôt que la théorie