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 (Einblendungen). - 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 Parameter (vars)
- duration — Sekunden (Standard: 0.5).
- delay — Sekunden Verzögerung vor 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 mit repeat die Richtung. - onComplete, onStart, onUpdate — Callback-Funktionen.
- immediateRender — Standard
truebei from()/fromTo(). Setzen Sie bei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element anvisieren,false, um Überschreibungen zu vermeiden.
Transforms und CSS
Bevorzugen Sie GSAPs Transform-Aliase gegenüber rohem 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 — bevorzugen Sie es gegenüber
opacity. Bei 0: setzt auchvisibility: hidden. - CSS-Variablen —
"--hue": 180. - svgOrigin (nur SVG) — globaler SVG-Koordinatenursprung. Nicht mit
transformOriginkombinieren. - Gerichtete Rotation —
"360_cw","-170_short","90_ccw". - clearProps —
"all"oder kommagetrennt; entfernt inline-Styles bei Abschluss. - Relative Werte —
"+=20","-=10","*=2".
Funktionsbasierte Werte
gsap.to(".item", {
x: (i, target, targets) => i * 50,
stagger: 0.1,
});
Easing
Eingebaute Ease-Funktionen: power1–power4, back, bounce, circ, elastic, expo, sine. Jede hat .in, .out, .inOut.
Standardwerte (Defaults)
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() (Responsives Design + Barrierefreiheit)
Führt eine Konfiguration nur aus, wenn ein Media-Query zutrifft; macht sie automatisch rückgängig, wenn das Query 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 vorheriger;">"— nach Ende des vorherigen;"<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 erstellen;
.play()aufrufen zum Starten. - repeat, yoyo — auf die gesamte Timeline anwendbar.
- defaults — Variablen, die in jeden untergeordneten 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
Animation von x, y, scale, rotation, opacity verbleibt im Compositor. Vermeiden Sie width, height, top, left, wenn Transforms denselben Effekt erzielen.
will-change
will-change: transform;
Nur für Elemente, die tatsächlich animiert werden.
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 anstelle vieler Tweens
Verwenden Sie stagger statt separater Tweens mit manuellen Verzögerungen.
Bereinigung
Pausieren Sie Animationen außerhalb des sichtbaren Bereichs oder killen Sie sie.
Referenzen (bedarfsweise geladen)
- references/effects.md — Fertige Effekte: Schreibmaschinentext, Audio-Visualizer. Lesen Sie dies, wenn Sie vorgefertigte 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 Sequenzierung hinzu. - Geben Sie Standardwerte (defaults) an den Timeline-Konstruktor weiter.
- Speichern Sie den Rückgabewert von Tween/Timeline, wenn Sie die Wiedergabe steuern möchten.
Nicht tun (Do Not)
- Layout-Eigenschaften (width/height/top/left) animieren, wenn Transforms ausreichen.
- svgOrigin und transformOrigin auf demselben SVG-Element verwenden.
- Animationen mit delay verketten, wenn eine Timeline sie sequenzieren kann.
- Tweens erstellen, bevor das DOM existiert.
- Bereinigung überspringen — killen Sie immer Tweens, wenn sie nicht mehr benötigt werden.