correction-performance-mouvement
Règle de lecture sélective
Commencez par :
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Ensuite, chargez uniquement les documents hérités, scripts, actifs ou exemples correspondant à la tâche réelle de l'utilisateur.
Corrigez les problèmes de performance d'animation.
Comment utiliser
-
/fixing-motion-performanceAppliquez ces contraintes à tout travail d'animation UI dans cette conversation. -
/fixing-motion-performance <fichier>Examinez le fichier par rapport à toutes les règles ci-dessous et signalez :- violations (citez la ligne ou l'extrait exact)
- pourquoi c'est important (une phrase courte)
- un correctif concret (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 utiliser
Référez-vous à ces directives lors :
- de l'ajout ou de la modification d'animations UI (CSS, WAAPI, Motion, rAF, GSAP)
- du refactoring d'interactions ou de transitions saccadées
- de l'implémentation de mouvement lié au défilement ou de dévoilement au défilement
- de l'animation de mise en page, filtres, masques, dégradés ou variables CSS
- de l'examen de composants utilisant
will-change, les transformations ou les mesures
Glossaire des étapes de rendu
- composite : transformation, opacité
- 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 | motifs jamais | critique |
| 2 | choisir le mécanisme | critique |
| 3 | mesure | élevé |
| 4 | défilement | élevé |
| 5 | peinture | moyen-élevé |
| 6 | calques | moyen |
| 7 | flou et filtres | moyen |
| 8 | transitions de vue | faible |
| 9 | limites des outils | critique |
Référence rapide
1. Motifs jamais (critique)
- n'entrelacez pas les lectures et écritures de mise en page dans la même frame
- n'animez pas la mise en page en continu sur des surfaces grandes ou significatives
- ne pilotez pas l'animation depuis
scrollTop,scrollYou les é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 chacun la mise en page
2. Choisir le mécanisme (critique)
- par défaut, utilisez
transformetopacitypour le mouvement - utilisez l'animation pilotée par JS uniquement lorsque l'interaction le nécessite
- l'animation de peinture ou de mise en page 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éduire la technique plutôt que 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 la mise en page de manière répétée pendant une animation
- préférez les transitions de type FLIP pour les effets de mise en page
- préférez les approches qui regroupent mesure et écritures
4. Défilement (élevé)
- préférez les Scroll ou View Timelines pour le mouvement lié au défilement lorsque disponibles
- utilisez
IntersectionObserverpour la visibilité et la mise en pause - n'interrogez pas la position de défilement pour l'animation
- mettez en pause ou arrêtez les animations lorsque hors écran
- le mouvement lié au défilement ne doit pas déclencher une mise en page ou une 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. Calques (moyen)
- le mouvement du compositeur nécessite une promotion de calque, ne la supposez jamais
- utilisez
will-changede manière temporaire et chirurgicale - évitez un grand nombre ou de grandes surfaces de calques promus
- validez le comportement des calques avec des outils lorsque la performance compte
7. Flou et filtres (moyen)
- gardez l'animation de flou petite (<=8px)
- utilisez le flou uniquement pour des effets courts et uniques
- n'animez jamais le flou en continu
- n'animez jamais le flou sur de grandes surfaces
- préférez l'opacité et
translateavant 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 interactives
- évitez les transitions de vue lorsque l'interruption ou l'annulation est requise
- traitez les changements de taille comme potentiellement déclencheurs de mise en page
9. Limites des outils (critique)
- ne migrez ou ne réécrivez pas 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 ou ne mélangez pas les styles dans le même composant
Correctifs courants
/* thrashing de mise en page : animez la transformation au lieu de la largeur */
/* avant */ .panel { transition: width 0.3s; }
/* après */ .panel { 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 mise en page
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// après — mesurez une fois, animez via 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 = ''; });
Guidance de révision
- appliquez d'abord les règles critiques (motifs jamais, limites des outils)
- choisissez le travail de rendu le moins coûteux correspondant à l'intention
- pour tout choix non par défaut, précisez la contrainte qui le justifie (taille de surface, durée ou exigence d'interaction)
- lors de la révision, préférez des notes actionnables et des alternatives concrètes plutôt que de la théorie
Limites
- Utilisez cette compétence uniquement lorsque la tâche correspond clairement au champ décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation spécifique à l'environnement, à des tests ou à un avis d'expert.
- Arrêtez-vous et demandez des clarifications si les entrées, permissions, limites de sécurité ou critères de succès requis sont manquants.