Web-Animationen optimieren
Kernregel
Messen Sie die tatsächliche Seite vor dem Bearbeiten. Ziel ist es nicht, Bewegungen zu entfernen, sondern dafür zu sorgen, dass Arbeiten außerhalb des Bildschirms gestoppt werden, sichtbare Bewegungen korrekt wieder aufgenommen werden und bei Routenwechseln/Mount-Bereinigung langlebige Ressourcen freigegeben werden.
Verwenden Sie Codex Browser, wenn verfügbar, insbesondere für localhost-Seiten. Verwenden Sie Chrome nur, wenn der Nutzer explizit danach fragt.
Arbeitsablauf
-
Repository-Kontext inspizieren.
AGENTS.mdoder lokale Anweisungen lesen.- Frühzeitig
git status --shortausführen. - Seitenkomponenten, Animation-Hooks, CSS-Keyframes,
requestAnimationFrame,setInterval,setTimeout, Canvas/WebGL/Physik-Komponenten, Media-Elemente, GSAP-Timelines/Tweens und bestehende Sichtbarkeits-Helfer finden. - Die Effekt-Bereinigung auf Event-Listener, Observer, RAF-Schleifen, Intervalle, Timer, externe Skripte, Media-Streams, WebGL-Texturen/Materialien/Geometrien/Renderer und asynchrone Arbeiten untersuchen, die nach dem Unmount abgeschlossen werden können.
- Wenn der Arbeitsbaum nicht sauber ist, von Anfang an einen engen Staging-Bereich planen.
-
Eine Baseline im Browser erfassen.
- Die genaue Route öffnen, die der Nutzer genannt hat.
- Profil oben, in der Mitte, im unteren Bereich/Footer und in einer mobilen Ansicht erstellen, wenn das Layout variieren könnte.
- CSS-Animationen nach berechnetem
animationName,animationPlayStateund Sichtbarkeit zählen.::beforeund::aftereinbeziehen. - Canvase/WebGL-Elemente separat inspizieren; CSS-Profiling beweist nicht, dass RAF-Schleifen gestoppt haben.
- Notieren, welche Animationsnamen außerhalb des Bildschirms laufen und welche DOM-Owner dafür verantwortlich sind.
- Bei Anfragen zu Speicher/Leaks zusätzlich die Anzahl der Elemente/Canvase/Bilder/Iframes, verfügbare JS-Heap-Metriken, eine Leerlaufprobe nach 10-30 Sekunden und eine kurze Routenzyklus-Probe erfassen. Wenn Heap-APIs
nullzurückgeben oder die Browser-Sandbox Monkey-Patching blockiert, dies erwähnen und sich auf stabile beobachtbare Zählungen plus Quellenaudit verlassen. - Belastungstests begrenzt halten. Ein Browser-Tab-Absturz während des Profilings ist ein Hinweis auf Überlastung, aber die Ursache nicht überbewerten, es sei denn, sie wird durch einen minimalen Test reproduziert.
- Siehe
references/browser-profiling.mdfür einen wiederverwendbaren Codex Browser Evaluator.
-
Den kleinsten Owner patchen, der die Bewegung kontrolliert.
- Einen vorhandenen Page-Reveal/Visibility-Hook bevorzugen, falls die App einen hat.
- Ansonsten einen
IntersectionObserverhinzufügen, der eine stabile Klasse wieis-offscreenauf Abschnitte und animierte Kind-Elemente umschaltet. - CSS-Animationen mit gezielten Regeln pausieren:
main > section.is-offscreen .expensive-animation,
.expensive-animation.is-offscreen {
animation-play-state: paused !important;
}
- Bei wiederholten Karten oder Platzhaltern das Karten-Shell und die animierten Nachkommen beobachten, nicht das gesamte Dokument.
- Bei Marquee/Ticker-Spuren die Spur pausieren, wenn ihr Abschnitt außerhalb des Bildschirms ist.
- Bei Skeleton-Ladern und Pseudo-Element-Glimmern bei Bedarf `::before`- und `::after`-Pause-Selektoren einschließen.
- Bei Canvas/WebGL/Physik-Schleifen die RAF-Schleife direkt steuern:
- Starten, wenn der Canvas/Container sichtbar wird.
- `requestAnimationFrame` abbrechen, wenn der Bildschirm verlassen wird.
- Beim Wiedereintreten fortsetzen.
- Observer trennen und Frames bei der Bereinigung abbrechen.
- Einen nicht-visuellen Debug-Marker wie `data-animation-active` hinzufügen, wenn dies der Browser-Überprüfung hilft.
- `prefers-reduced-motion` respektieren, wenn die Komponente dies bereits tut, und vermeiden, React-Render-Schleifen für Scroll-/Animationsstatus einzuführen.
- Zur Härtung gegen Leaks:
- Jedes vom Effekt erstellte Timeout/Interval löschen.
- RAF vor dem Unmount und vor dem Neustarten einer Schleife abbrechen.
- `IntersectionObserver`, `ResizeObserver`, `MutationObserver` und benutzerdefinierte Subscriptions trennen.
- Globale/window/document-Listener mit derselben Handler-Referenz entfernen.
- Three/WebGL-Texturen, Materialien, Geometrien, Renderer entsorgen und Renderer-DOM-Knoten entfernen.
- GSAP-Tweens/Timelines für DOM-Knoten und mutable Objekte wie Shader-Uniforms beenden.
- Media-Streams stoppen und getrennte Video/Audio-Quellen pausieren.
- Asynchrone Lader mit einem `isDisposed`-Flag schützen und geladene Ressourcen entsorgen, wenn sie nach dem Unmount auflösen.
- Bei der React-Bereinigung die `ref.current`-Werte innerhalb des Effekts erfassen, bevor die Bereinigung zurückgegeben wird, falls Lint warnt, dass sich der Ref ändern könnte.
- Physik- oder Simulations-Frame-Deltas nach Sichtbarkeitspausen begrenzen, damit verzögerte Frames keine überdimensionierten Updates ausführen.
4. Verhalten überprüfen, nicht nur Builds.
- Route neu laden und dieselben Top/Mid/Footer/Mobile-Profile erneut ausführen.
- Zielergebnis: offscreenRunningCount: 0 für die getesteten Seitenabschnitte.
- Bestätigen, dass sichtbare Animationen noch laufen oder beim Hineinscrollen wieder aufgenommen werden.
- Bestätigen, dass RAF/Canvas-Schleifen außerhalb des Bildschirms inaktiv und im sichtbaren Bereich aktiv sind, oder anderweitig die Abbrechung aus dem Quell- oder Laufzeitzustand nachweisen.
- Bei Leak-Audits die Vorher-/Nachher-Routenzyklen und Leerlaufproben vergleichen. DOM/Canvas/Bild-Zähler sollten nach wiederholter Navigation zur gleichen Baseline zurückkehren, wobei kleine erwartete Änderungen durch asynchrone Inhalte toleriert werden.
- Eine normale Seiteninteraktion wie Suche/Filter/Navigation durchführen, damit der Observer dynamische Inhalte nicht unterbricht.
- Konsolenwarnungen/-fehler in einem frischen Tab überprüfen.
- Lokale Prüfungen durchführen.
- Die normalen Gates des Repositorys verwenden. Bei React/Vite-Apps sind dies oft:
git diff --check
npm run lint
npm run build
- Bekannte nicht-fatale Warnungen getrennt von Fehlern erwähnen.
6. Eng committen, wenn es die Repo-/Benutzeranweisungen erfordern. - Wenn nicht verwandte, nicht bereinigte Änderungen existieren, einen isolierten Index verwenden:
rm -f /tmp/<task>-index
GIT_INDEX_FILE=/tmp/<task>-index git read-tree HEAD
# Nur die beabsichtigten Hunks auf den temporären Index anwenden.
GIT_INDEX_FILE=/tmp/<task>-index git diff --cached --check
GIT_INDEX_FILE=/tmp/<task>-index git commit -m "Offscreen-<Seite>-Animationen pausieren"
git restore --staged <dateien> 2>/dev/null || true
- Niemals breite Dateien aus einem nicht sauberen Arbeitsbaum stagen, es sei denn, jeder Hunk gehört zur Aufgabe.
7. Mit Nachweisen berichten. - Mit Ergebnissen beginnen: was noch lief, was leakanfällig aussah und was nicht gemessen werden konnte. - Quellenaudit-Risiken von Live-Browser-Messungen trennen. - Die genauen abgetasteten Routen, Offscreen-Animation-Zählungen, Stabilität der DOM/Canvas-Zähler, Routenzyklus-Ergebnis und lokale Prüfungen einschließen. - Einschränkungen klar benennen, insbesondere nicht verfügbare Heap-Zähler oder blockierte Browser-Instrumentierung.
Gute Fix-Muster
- Abschnittsebene
is-offscreenplus Elementebeneis-offscreenfür lange Abschnitte, in denen Animationen untergeordneter Elemente unterhalb der Falzlinie weiterlaufen können. - Gemeinsame Sichtbarkeits-Selektor-Konstanten pro Route, z. B.
COURSES_PAGE_ANIMATION_VISIBILITY_SELECTOR. IntersectionObserver-Schwellwerte um0.01für die Animationssteuerung.- Direkte RAF-Schleifensteuerung für WebGL/Canvas-Effekte; CSS
animation-play-statekann JavaScript-Render-Schleifen nicht pausieren. - Frame-Delta-Begrenzungen für Physik-Schleifen, die nach einer Pause oder einem verzögerten Frame fortgesetzt werden.
- Erfasste Bereinigungs-Refs für React-Refs, die von GSAP/WebGL-Effekten verwendet werden.
isDisposed-Guards für Bild/Video/Textur/Daten-Lader, die nach dem Unmount auflösen können.- Kurze Leerlauf- und Routenzyklus-Proben, um akkumulierende DOM-Knoten, Canvase, Iframes oder nicht freigegebene Medien zu erfassen.
Vermeiden
- Alle Animationen entfernen, um das Profil zu bestehen.
- Sichtbare Hero-Animationen pausieren, weil ein übergeordneter Selektor zu breit ist.
- Annahme, dass
animation-play-statePseudo-Elemente oder JavaScript-RAF-Schleifen abdeckt. - Sich auf eine einzige Messung am Seitenanfang bei langen Seiten verlassen.
- Nicht verfügbare Heap-Zähler als Beweis für das Fehlen eines Memory-Leaks behandeln.
- Unbegrenzte Belastungsschleifen im Browser ausführen; begrenzte Zyklen verwenden und Abstürze ohne Überbetonung der Kausalität aufzeichnen.
- Screenshots allein als Performance-Nachweis verwenden.
- Nicht zusammenhängende lokale Hunks im Commit mitnehmen.