ScrollTrigger
Für die Verwendung von ScrollTrigger mit Glaze ist keine spezielle Syntax erforderlich. Da es in der Eigenschaft scrollTrigger des Animationsobjekts definiert ist, kannst du seine Einstellungen per Punktnotation anpassen.
Einrichtung
Registriere zuerst ScrollTrigger bei GSAP:
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"
gsap.registerPlugin(ScrollTrigger)
Initialisiere dann Glaze wie gewohnt.
Verwendung
Füge deiner Animation die Eigenschaften scrollTrigger.* hinzu:
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>
[&] bedeutet „Dieses Element als Auslöser verwenden“ (wie & in Selektoren).
Bei einem eigenständigen Element verschiebt Glaze die Einstellungen scrollTrigger von der Animation auf die Timeline, die es für dieses Element erstellt. Dadurch wird die gesamte Animation durch Scrollen gesteuert.
Innerhalb von Timelines
Die untergeordneten Elemente eines tl-Elements sind Tweens in einer gemeinsamen Timeline, und Glaze belässt ihre Einstellungen scrollTrigger beim Tween. GSAP unterstützt keinen ScrollTrigger für einen in einer Timeline verschachtelten Tween. Füge ihn daher stattdessen dem Timeline-Element hinzu und verwende für Timeline-Einstellungen die Doppelpunkt-Notation:
<div data-animate="tl scrollTrigger:trigger-[&]|start-[top_center]">
<div data-animate="to:rotate-360"></div>
<div data-animate="to:rotate-360"></div>
</div>
Damit jedes Element beim Scrollen ausgelöst wird, lege es in den Timeline-Standardwerten fest.
Häufige Optionen
<div
data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
<div class="flex h-[50vh] items-center">
<div
class="h-20 w-20 rounded-xl bg-amber-500 sm:invisible"
data-animate="from:autoAlpha-0|rotate-180|y-50|scrollTrigger.trigger-[&]|boxShadow-[0_0_100px_20px_orange]|scrollTrigger.scrub-true|scrollTrigger.start-[top_center]|scrollTrigger.end-[-=200]"
></div>
</div>
| Option | Funktion |
|---|---|
scrollTrigger.trigger-[&] |
Element, das die Animation auslöst |
scrollTrigger.start-[top_center] |
Startzeitpunkt (Elementposition + Viewportposition) |
scrollTrigger.end-[bottom_top] |
Endzeitpunkt |
scrollTrigger.scrub-true |
Animationsfortschritt an Scrollposition koppeln |
scrollTrigger.markers-true |
Debug-Marker anzeigen (hilfreich während der Entwicklung) |
Denk daran, in Werten Unterstriche statt Leerzeichen zu verwenden: [top_center] statt [top center].