Bewegungsperformance beheben
Beheben Sie Animations-Performance-Probleme.
Verwendung
-
/fixing-motion-performanceWendet diese Einschränkungen auf alle UI-Animationsarbeiten in dieser Konversation an. -
/fixing-motion-performance <datei>Überprüft die Datei anhand aller untenstehenden Regeln und meldet:- Verstöße (zitieren Sie die genaue Zeile oder den Code-Ausschnitt)
- warum es wichtig ist (ein kurzer Satz)
- eine konkrete Lösung (Code-Vorschlag)
Migrieren Sie keine Animationsbibliotheken, es sei denn, dies wird ausdrücklich verlangt. Wenden Sie die Regeln innerhalb des bestehenden Stacks an.
Wann verwenden
Ziehen Sie diese Richtlinien heran, wenn:
- UI-Animationen hinzugefügt oder geändert werden (CSS, WAAPI, Motion, rAF, GSAP)
- ruckelnde Interaktionen oder Übergänge refaktoriert werden
- scrollgebundene Animationen oder Einblendungen beim Scrollen implementiert werden
- Layout, Filter, Masken, Verläufe oder CSS-Variablen animiert werden
- Komponenten überprüft werden, die will-change, transforms oder Messungen verwenden
Glossar der Rendering-Schritte
- composite: 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 | Werkzeuggrenzen | kritisch |
Kurzreferenz
1. Never Patterns (kritisch)
- Layout-Lese- und Schreiboperationen nicht im selben Frame mischen
- Layout nicht kontinuierlich auf großen oder bedeutenden Oberflächen animieren
- Animation nicht über scrollTop, scrollY oder Scroll-Ereignisse steuern
- Keine requestAnimationFrame-Schleifen ohne Abbruchbedingung
- Nicht mehrere Animationssysteme mischen, die jeweils Layout messen oder mutieren
2. Mechanismus wählen (kritisch)
- Standardmäßig transform und opacity für Bewegung verwenden
- JavaScript-gesteuerte Animationen nur verwenden, wenn die Interaktion es erfordert
- Paint- oder Layout-Animation ist nur auf kleinen, isolierten Oberflächen akzeptabel
- Einmal-Effekte sind häufiger akzeptabel als kontinuierliche Bewegung
- Technik downgraden statt Bewegung komplett entfernen
3. Messung (hoch)
- Einmal messen, dann über transform oder opacity animieren
- Alle DOM-Lesevorgänge vor den Schreibvorgängen bündeln
- Layout nicht wiederholt während einer Animation messen
- FLIP-ähnliche Übergänge für layoutartige Effekte bevorzugen
- Ansätze bevorzugen, die Messungen und Schreibvorgänge bündeln
4. Scrollen (hoch)
- Scroll- oder View-Timelines für scrollgebundene Bewegung bevorzugen, wenn verfügbar
- IntersectionObserver für Sichtbarkeit und Pausieren verwenden
- Scroll-Position nicht für Animation abfragen
- Animationen pausieren oder stoppen, wenn das Element nicht sichtbar ist
- Scrollgebundene Bewegung darf kein kontinuierliches Layout oder Paint auf großen Oberflächen auslösen
5. Paint (mittel-hoch)
- Paint-auslösende Animation ist nur auf kleinen, isolierten Elementen erlaubt
- Paint-intensive Eigenschaften nicht auf großen Containern animieren
- CSS-Variablen für transform, opacity oder position nicht animieren
- Geerbte CSS-Variablen nicht animieren
- Animiere CSS-Variablen lokal begrenzen und Vererbung vermeiden
6. Ebenen (mittel)
- Compositor-Bewegung erfordert Ebenen-Promotion, nie annehmen
- will-change zeitlich begrenzt und gezielt einsetzen
- Viele oder große Promoted-Layer 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 nie kontinuierlich animieren
- Unschärfe nie auf großen Oberflächen animieren
- opacity und translate vor Unschärfe bevorzugen
8. View-Transitions (niedrig)
- View-Transitions nur für Navigationsänderungen verwenden
- View-Transitions für interaktionsintensive UI vermeiden
- View-Transitions vermeiden, wenn Unterbrechung oder Abbruch erforderlich ist
- Größenänderungen als potenziell layoutauslösend behandeln
9. Werkzeuggrenzen (kritisch)
- Animationsbibliotheken nicht migrieren oder umschreiben, es sei denn, dies wird ausdrücklich verlangt
- Diese Regeln innerhalb des bestehenden Animationssystems anwenden
- APIs nicht teilweise migrieren oder Stile innerhalb derselben Komponente mischen
Häufige Lösungen
/* Layout-Thrashing: Statt width besser transform animieren */
/* vorher */ .panel { transition: width 0.3s; }
/* nachher */ .panel { transition: transform 0.3s; }
/* Scrollgebunden: Statt JS scroll-timeline verwenden */
/* vorher */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* nachher */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// Messung: Lesevorgänge vor Schreibvorgängen bündeln (FLIP)
// vorher — Layout-Thrashing
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 = ''; });
Überprüfungsrichtlinien
- Kritische Regeln zuerst durchsetzen (Never Patterns, Werkzeuggrenzen)
- Die kostengünstigste Render-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 Überprüfungen handlungsorientierte Hinweise und konkrete Alternativen gegenüber theoretischen Ausführungen bevorzugen
Einschränkungen
- Verwenden Sie dieses Skill nur, wenn die Aufgabe eindeutig zum oben beschriebenen Umfang passt.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Fragen Sie nach und holen Sie Klarstellungen ein, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.