Animations-Performance beheben
Behebt Probleme mit der Animations-Performance.
Verwendung
-
/fixing-motion-performanceWendet diese Einschränkungen auf sämtliche UI-Animationen in dieser Konversation an. -
/fixing-motion-performance <Datei>Überprüft die Datei anhand aller untenstehenden Regeln und meldet:- Verstöße (zitiere die genaue Zeile oder den Code-Ausschnitt)
- warum es wichtig ist (ein kurzer Satz)
- einen konkreten Fix (Code-Vorschlag auf Code-Ebene)
Migriere keine Animationsbibliotheken, es sei denn, es wird ausdrücklich darum gebeten. Wende die Regeln innerhalb des vorhandenen Stacks an.
Wann verwenden
Beziehe dich auf diese Richtlinien, wenn:
- UI-Animationen hinzugefügt oder geändert werden (CSS, WAAPI, Motion, rAF, GSAP)
- ruckelnde Interaktionen oder Übergänge refaktoriert werden
- scroll-gebundene Bewegungen 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
- Compositing: transform, opacity
- Paint: color, borders, gradients, masks, images, filters
- Layout: size, position, flow, grid, flex
Regelkategorien nach Priorität
| Priorität | Kategorie | Auswirkung |
|---|---|---|
| 1 | Niemals-Muster | 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 | Tool-Grenzen | Kritisch |
Kurzreferenz
1. Niemals-Muster (kritisch)
- Layout-Reads und -Writes dürfen nicht im selben Frame gemischt werden
- Layout darf nicht kontinuierlich auf großen oder bedeutenden Flächen animiert werden
- Animationen dürfen nicht über scrollTop, scrollY oder Scroll-Ereignisse gesteuert werden
- Keine requestAnimationFrame-Schleifen ohne Abbruchbedingung
- Mehrere Animationssysteme, die Layout messen oder verändern, dürfen nicht gemischt werden
2. Mechanismus wählen (kritisch)
- Standardmäßig transform und opacity für Bewegungen verwenden
- JS-basierte Animationen nur verwenden, wenn die Interaktion sie erfordert
- Paint- oder Layout-Animationen sind nur auf kleinen, isolierten Flächen akzeptabel
- Einmalige Effekte sind häufiger akzeptabel als kontinuierliche Bewegungen
- Technik herunterstufen ist besser, als Bewegung vollständig zu entfernen
3. Messung (hoch)
- Einmal messen, dann über transform oder opacity animieren
- Alle DOM-Reads vor den Writes bündeln
- Layout nicht wiederholt während einer Animation auslesen
- FLIP-ähnliche Übergänge für layout-ähnliche Effekte bevorzugen
- Ansätze bevorzugen, die Messung und Writes bündeln
4. Scrollen (hoch)
- Scroll- oder View-Timelines für scroll-gebundene Bewegungen bevorzugen, wenn verfügbar
- IntersectionObserver für Sichtbarkeit und Pausieren verwenden
- Scrollposition 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 Flächen auslösen
5. Paint (mittel-hoch)
- Paint-auslösende Animationen sind 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
- Vererbte CSS-Variablen nicht animieren
- Animierte CSS-Variablen lokal begrenzen und Vererbung vermeiden
6. Ebenen (mittel)
- Compositor-Bewegungen erfordern Layer-Promotion, nicht darauf verlassen
- will-change temporär und punktuell einsetzen
- Viele oder große Promoted-Layer vermeiden
- Ebenenverhalten mit Tooling validieren, wenn Performance wichtig ist
7. Unschärfe und Filter (mittel)
- Unschärfe-Animationen klein halten (<=8px)
- Unschärfe nur für kurze, einmalige Effekte verwenden
- Unschärfe niemals kontinuierlich animieren
- Unschärfe niemals auf großen Flächen animieren
- Opacity und translate vor Unschärfe bevorzugen
8. View-Transitions (niedrig)
- View-Transitions nur für Navigations-übergreifende Änderungen verwenden
- View-Transitions für interaktionsintensive UI vermeiden
- View-Transitions vermeiden, wenn Unterbrechung oder Abbruch erforderlich ist
- Größenänderungen als potenziell layout-auslösend behandeln
9. Tool-Grenzen (kritisch)
- Animationsbibliotheken nicht migrieren oder neu schreiben, es sei denn, es wird ausdrücklich darum gebeten
- Diese Regeln innerhalb des vorhandenen Animationssystems anwenden
- APIs nicht teilweise migrieren oder Stile innerhalb derselben Komponente mischen
Häufige Lösungen
/* 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-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üfungsleitfaden
- Zuerst kritische Regeln durchsetzen (Niemals-Muster, Tool-Grenzen)
- Die kostengünstigste Renderarbeit wählen, die der Absicht entspricht
- Für jede nicht standardmäßige Wahl die Einschränkung angeben, die sie rechtfertigt (Flächengröße, Dauer oder Interaktionsanforderung)
- Bei der Überprüfung handlungsorientierte Hinweise und konkrete Alternativen bevorzugen, nicht nur Theorie
Einschränkungen
- Verwende dieses Skill nur, wenn die Aufgabe eindeutig mit dem oben beschriebenen Umfang übereinstimmt.
- Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
- Halte inne und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.