fixing-motion-performance
Beheben Sie Performance-Probleme bei Animationen.
Verwendung
-
/fixing-motion-performanceWendet diese Einschränkungen auf alle UI-Animationen in dieser Konversation an. -
/fixing-motion-performance <datei>Überprüft die Datei anhand aller folgenden Regeln und meldet:- Verstöße (zitiert die genaue Zeile oder den Code-Ausschnitt)
- warum es wichtig ist (ein kurzer Satz)
- eine konkrete Korrektur (Code-Vorschlag)
Migrieren Sie keine Animationsbibliotheken, es sei denn, dies wird ausdrücklich verlangt. Wenden Sie die Regeln innerhalb des vorhandenen Stacks an.
Wann verwenden
Ziehen Sie diese Richtlinien heran, wenn:
- Sie UI-Animationen hinzufügen oder ändern (CSS, WAAPI, Motion, rAF, GSAP)
- Sie ruckelige Interaktionen oder Übergänge überarbeiten
- Sie scroll-gebundene Bewegungen oder „Reveal-on-Scroll“ implementieren
- Sie Layout, Filter, Masken, Verläufe oder CSS-Variablen animieren
- Sie Komponenten überprüfen, die
will-change,transformoder Messungen verwenden
Glossar der Rendering-Schritte
- compositing: transform, opacity
- paint: Farbe, Rahmen, Verläufe, Masken, Bilder, Filter
- layout: Größe, Position, Fluss, Grid, Flex
Regelkategorien nach Priorität
| Priorität | Kategorie | Auswirkung |
|---|---|---|
| 1 | never patterns | kritisch |
| 2 | Mechanismus wählen | kritisch |
| 3 | Messung | hoch |
| 4 | Scrollen | hoch |
| 5 | Paint | mittel-hoch |
| 6 | Ebenen | mittel |
| 7 | Unschärfe und Filter | mittel |
| 8 | View Transitions | niedrig |
| 9 | Werkzeug-Grenzen | kritisch |
Kurzreferenz
1. Never Patterns (kritisch)
- Mischen Sie keine Layout-Reads und -Writes im selben Frame
- Animieren Sie Layout nicht kontinuierlich auf großen oder bedeutenden Oberflächen
- Treiben Sie Animationen nicht über
scrollTop,scrollYoder Scroll-Ereignisse an - Keine
requestAnimationFrame-Schleifen ohne Stopp-Bedingung - Mischen Sie nicht mehrere Animationssysteme, die jeweils Layout messen oder verändern
2. Mechanismus wählen (kritisch)
- Standardmäßig
transformundopacityfür Bewegungen verwenden - JS-gesteuerte Animationen nur verwenden, wenn die Interaktion es erfordert
- Paint- oder Layout-Animationen sind nur auf kleinen, isolierten Oberflächen akzeptabel
- Einmalige Effekte sind öfter akzeptabel als kontinuierliche Bewegungen
- Bevorzugen Sie eine Herabstufung der Technik gegenüber vollständigem Entfernen der Bewegung
3. Messung (hoch)
- Einmal messen, dann über
transformoderopacityanimieren - Alle DOM-Reads vor den Writes bündeln
- Layout während einer Animation nicht wiederholt auslesen
- FLIP-ähnliche Übergänge für layout-ähnliche Effekte bevorzugen
- Ansätze bevorzugen, die Messung und Schreibvorgänge bündeln
4. Scrollen (hoch)
- Scroll- oder View-Timelines für scroll-gebundene Bewegungen bevorzugen, wenn verfügbar
IntersectionObserverfür Sichtbarkeit und Pausieren verwenden- Scroll-Position nicht für Animationen abfragen
- Animationen pausieren oder stoppen, wenn sie nicht sichtbar sind
- Scroll-gebundene Bewegungen dürfen kein kontinuierliches Layout oder Paint auf großen Oberflächen auslösen
5. Paint (mittel-hoch)
- Paint-auslösende Animationen sind nur auf kleinen, isolierten Elementen erlaubt
- Paint-lastige Eigenschaften nicht auf großen Containern animieren
- CSS-Variablen nicht für
transform,opacityoder Position animieren - Vererbte CSS-Variablen nicht animieren
- Animierte CSS-Variablen lokal begrenzen und Vererbung vermeiden
6. Ebenen (mittel)
- Compositor-Bewegung erfordert Layer-Promotion – niemals annehmen
will-changezeitlich begrenzt und gezielt einsetzen- Viele oder große hochgestufte Ebenen vermeiden
- Ebenenverhalten mit Werkzeugen validieren, wenn Performance wichtig ist
7. Unschärfe und Filter (mittel)
- Unschärfe-Animation klein halten (<=8px)
- Unschärfe nur für kurze, einmalige Effekte verwenden
- Unschärfe niemals kontinuierlich animieren
- Unschärfe niemals auf großen Oberflächen animieren
opacityundtranslatevor Unschärfe bevorzugen
8. View Transitions (niedrig)
- View Transitions nur für Navigationsebene-Änderungen verwenden
- View Transitions bei interaktionslastigen UIs vermeiden
- View Transitions vermeiden, wenn Unterbrechung oder Abbruch erforderlich ist
- Größenänderungen als potenziell layout-auslösend behandeln
9. Werkzeug-Grenzen (kritisch)
- Animationsbibliotheken nicht migrieren oder umschreiben, es sei denn, es wird ausdrücklich verlangt
- Diese Regeln innerhalb des vorhandenen Animationssystems anwenden
- APIs niemals teilweise migrieren oder Stile innerhalb derselben Komponente mischen
Häufige Korrekturen
/* Layout-Thrashing: transform statt width animieren */
/* vorher */ .panel { transition: width 0.3s; }
/* nachher */ .panel { transition: transform 0.3s; }
/* scroll-gebunden: scroll-timeline statt JS verwenden */
/* vorher */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* nachher */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// Messung: Reads vor Writes bündeln (FLIP)
// vorher — Layout-Thrash
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// nachher — einmal messen, über transform animieren
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 = ''; });
Prüfhinweise
- Zuerst kritische Regeln durchsetzen (never patterns, Werkzeug-Grenzen)
- Die kostengünstigste Rendering-Arbeit wählen, die der Absicht entspricht
- Bei jeder nicht standardmäßigen Wahl die Einschränkung nennen, die sie rechtfertigt (Oberflächengröße, Dauer oder Interaktionsanforderung)
- Bei der Überprüfung umsetzbare Hinweise und konkrete Alternativen gegenüber theoretischen Ausführungen bevorzugen
Einschränkungen
- Verwenden Sie dieses Skill nur, wenn die Aufgabe klar dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
- Halten Sie an und fragen Sie nach, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.