GSAP
Kern-Tween-Methoden
- gsap.to(targets, vars) — Animiert vom aktuellen Zustand zu
vars. Am häufigsten verwendet. - gsap.from(targets, vars) — Animiert von
varszum aktuellen Zustand (Eingänge). - gsap.fromTo(targets, fromVars, toVars) — Expliziter Start- und Endzustand.
- gsap.set(targets, vars) — Wendet sofort an (Dauer 0).
Verwenden Sie immer camelCase-Eigenschaftsnamen (z.B. backgroundColor, rotationX).
Häufige Variablen
- duration — Sekunden (Standard 0,5).
- delay — Sekunden vor dem Start.
- ease —
"power1.out"(Standard),"power3.inOut","back.out(1.7)","elastic.out(1, 0.3)","none". - stagger — Zahl
0.1oder Objekt:{ amount: 0.3, from: "center" },{ each: 0.1, from: "random" }. - overwrite —
false(Standard),trueoder"auto". - repeat — Zahl oder
-1für unendlich. yoyo — wechselt die Richtung mit Wiederholung. - onComplete, onStart, onUpdate — Callbacks.
- immediateRender — Standard
truefür from()/fromTo(). Setzen Siefalsebei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element ansprechen, um Überschreiben zu vermeiden.
Transforms und CSS
Bevorzugen Sie GSAPs Transform-Aliase gegenüber einem rohen transform-String:
| GSAP-Eigenschaft | Äquivalent |
|---|---|
x, y, z | translateX/Y/Z (px) |
xPercent, yPercent | translateX/Y in % |
scale, scaleX, scaleY | scale |
rotation | rotate (Grad) |
rotationX, rotationY | 3D-Rotation |
skewX, skewY | skew |
transformOrigin | transform-origin |
- autoAlpha — Bevorzugt gegenüber
opacity. Bei 0 wird auchvisibility: hiddengesetzt. - CSS-Variablen —
"--hue": 180. - svgOrigin (nur SVG) — Ursprung im globalen SVG-Koordinatenraum. Nicht mit
transformOriginkombinieren. - Gerichtete Rotation —
"360_cw","-170_short","90_ccw". - clearProps —
"all"oder durch Komma getrennt; entfernt Inline-Stile bei Abschluss. - Relative Werte —
"+=20","-=10","*=2".
Funktionsbasierte Werte
gsap.to(".item", {
x: (i, target, targets) => i * 50,
stagger: 0.1,
});
Easing
Eingebaute Easing-Funktionen: power1–power4, back, bounce, circ, elastic, expo, sine. Jedes hat .in, .out, .inOut.
Standardwerte
gsap.defaults({ duration: 0.6, ease: "power2.out" });
Tweens steuern
const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);
gsap.matchMedia() (Responsiv + Barrierefreiheit)
Führt das Setup nur aus, wenn ein Media Query zutrifft; macht es automatisch rückgängig, wenn es nicht mehr zutrifft.
let mm = gsap.matchMedia();
mm.add(
{
isDesktop: "(min-width: 800px)",
reduceMotion: "(prefers-reduced-motion: reduce)",
},
(context) => {
const { isDesktop, reduceMotion } = context.conditions;
gsap.to(".box", {
rotation: isDesktop ? 360 : 180,
duration: reduceMotion ? 0 : 2,
});
},
);
Timelines
Eine Timeline erstellen
const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });
Positionsparameter
Das dritte Argument steuert die Platzierung:
- Absolut:
1— bei 1s - Relativ:
"+=0.5"— nach Ende;"-=0.2"— vor Ende - Label:
"intro","intro+=0.3" - Ausrichtung:
"<"— gleicher Start wie vorheriges;">"— nachdem vorheriges endet;"<0.2"— 0,2s nach Start des vorherigen
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // gleicher Start wie .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0,2s nach Start von .b
Labels
tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");
Timeline-Optionen
- paused: true — pausiert erzeugen;
.play()zum Starten aufrufen. - repeat, yoyo — auf die gesamte Timeline anwenden.
- defaults — Variablen, die in jedes untergeordnete Tween eingefügt werden.
Timelines verschachteln
const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);
Wiedergabesteuerung
tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().
Performance
Transform und Opacity bevorzugen
Das Animieren von x, y, scale, rotation, opacity bleibt auf dem Compositor. Vermeiden Sie width, height, top, left, wenn Transforms den gleichen Effekt erzielen.
will-change
will-change: transform;
Nur auf Elementen, die tatsächlich animieren.
gsap.quickTo() für häufige Aktualisierungen
let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
xTo(e.pageX);
yTo(e.pageY);
});
Stagger > Viele Tweens
Verwenden Sie stagger anstelle von separaten Tweens mit manuellen Verzögerungen.
Aufräumen
Animationen, die nicht mehr sichtbar sind, pausieren oder beenden.
Referenzen (bei Bedarf geladen)
- references/effects.md — Direkt einsetzbare Effekte: Schreibmaschinentext, Audio-Visualizer. Lesen Sie diese, wenn Sie fertige Effektmuster für HyperFrames benötigen.
Best Practices
- Verwenden Sie camelCase-Eigenschaftsnamen; bevorzugen Sie Transform-Aliase und autoAlpha.
- Bevorzugen Sie Timelines gegenüber Verkettung mit delay; verwenden Sie den Positionsparameter.
- Fügen Sie Labels mit
addLabel()für lesbare Abläufe hinzu. - Übergeben Sie Standardwerte an den Timeline-Konstruktor.
- Speichern Sie den Rückgabewert von Tween/Timeline, wenn Sie die Wiedergabe steuern möchten.
Nicht tun
- Layout-Eigenschaften (width/height/top/left) animieren, wenn Transforms ausreichen.
- Beide svgOrigin und transformOrigin auf demselben SVG-Element verwenden.
- Animationen mit delay verketten, wenn eine Timeline sie sequenzieren kann.
- Tweens erstellen, bevor das DOM existiert.
- Aufräumen überspringen — Tweens immer beenden, wenn sie nicht mehr benötigt werden.