Behebung von Bewegungs-Performance
Regel zum selektiven Lesen
Beginne mit:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Lade dann nur die geerbten Dokumente, Skripte, Ressourcen oder Beispiele, die zur tatsächlichen Aufgabe des Benutzers passen.
Behebe Probleme mit Animations-Performance.
Verwendung
-
/fixing-motion-performanceWende diese Einschränkungen auf jede UI-Animation in dieser Konversation an. -
/fixing-motion-performance <datei>Überprüfe die Datei anhand aller untenstehenden Regeln und melde:- Verstöße (zitiere die exakte Zeile oder den Code-Ausschnitt)
- Warum es wichtig ist (ein kurzer Satz)
- Eine konkrete Behebung (Code-Vorschlag)
Migriere keine Animationsbibliotheken, es sei denn, es wird ausdrücklich darum gebeten. Wende die Regeln innerhalb des bestehenden Stacks an.
Wann verwenden
Diese Richtlinien sollten herangezogen werden, wenn:
- UI-Animationen hinzugefügt oder geändert werden (CSS, WAAPI, Motion, rAF, GSAP)
- ruckelige Interaktionen oder Übergänge umgestaltet werden
- scrollgebundene Bewegung oder Einblenden beim Scrollen implementiert wird
- Layout, Filter, Masken, Farbverläufe oder CSS-Variablen animiert werden
- Komponenten überprüft werden, die will-change, Transformationen oder Messungen verwenden
Glossar der Render-Schritte
- zusammensetzen (composite): transform, opacity
- malen (paint): Farbe, Rahmen, Farbverläufe, Masken, Bilder, Filter
- layout (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 | Malen | mittel-hoch |
| 6 | Ebenen | mittel |
| 7 | Unschärfe und Filter | mittel |
| 8 | View-Übergänge | niedrig |
| 9 | Werkzeug-Grenzen | kritisch |
Kurzreferenz
1. Never Patterns (kritisch)
- Layout-Lese- und -Schreibvorgänge nicht im selben Frame verschachteln
- Layout nicht kontinuierlich auf großen oder bedeutenden Oberflächen animieren
- Animation nicht von scrollTop, scrollY oder Scroll-Ereignissen aus steuern
- Keine requestAnimationFrame-Schleifen ohne Abbruchbedingung
- Mehrere Animationssysteme, die jeweils Layout messen oder verändern, nicht mischen
2. Mechanismus wählen (kritisch)
- Standardmäßig transform und opacity für Bewegung verwenden
- JS-gesteuerte Animation nur verwenden, wenn die Interaktion es erfordert
- Paint- oder Layout-Animation ist nur auf kleinen, isolierten Oberflächen akzeptabel
- Einmalige Effekte sind häufiger akzeptabel als kontinuierliche Bewegung
- Technik lieber herabstufen als 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 auslesen
- FLIP-artige Ü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 scrollgebundene Bewegung bevorzugen, falls verfügbar
- IntersectionObserver für Sichtbarkeit und Pausieren verwenden
- Scroll-Position nicht für Animation abfragen
- Animation pausieren oder stoppen, wenn nicht im sichtbaren Bereich
- Scrollgebundene Bewegung darf kein kontinuierliches Layout oder Malen auf großen Oberflächen auslösen
5. Malen (mittel-hoch)
- Paint-auslösende Animation ist nur auf kleinen, isolierten Elementen erlaubt
- Paint-intensive Eigenschaften nicht auf großen Containern animieren
- CSS-Variablen nicht für transform, opacity oder Position animieren
- Vererbte CSS-Variablen nicht animieren
- Animierte CSS-Variablen lokal begrenzen und Vererbung vermeiden
6. Ebenen (mittel)
- Compositor-Bewegung erfordert Ebenen-Hochstufung, niemals voraussetzen
- will-change nur temporär und gezielt verwenden
- Viele oder große hochgestufte Ebenen vermeiden
- Ebenenverhalten mit Werkzeugen validieren, wenn Leistung 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
- opacity und translate vor Unschärfe bevorzugen
8. View-Übergänge (niedrig)
- View-Übergänge nur für navigationsebene Änderungen verwenden
- View-Übergänge für interaktionsreiche UI vermeiden
- View-Übergänge 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 darum gebeten
- Diese Regeln innerhalb des bestehenden Animationssystems anwenden
- APIs niemals teilweise migrieren oder Stile innerhalb derselben Komponente mischen
Häufige Behebungen
/* Layout-Thrashing: transform statt width animieren */
/* vorher */ .panel { transition: width 0.3s; }
/* nachher */ .panel { transition: transform 0.3s; }
/* scrollgebunden: scroll-timeline statt JS 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-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 = ''; });
Überprüfungsrichtlinien
- Zuerst kritische Regeln durchsetzen (Never Patterns, Werkzeug-Grenzen)
- Die kostengünstigste Render-Arbeit wählen, die der Absicht entspricht
- Bei jeder nicht standardmäßigen Wahl die Einschränkung angeben, die sie rechtfertigt (Oberflächengröße, Dauer oder Interaktionsanforderung)
- Bei Überprüfungen handlungsorientierte Hinweise und konkrete Alternativen gegenüber der Theorie bevorzugen
Einschränkungen
- Verwende diese Fähigkeit nur, wenn die Aufgabe eindeutig in den oben beschriebenen Umfang fällt.
- Behandele die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halte inne und bitte um Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.