Zum Inhalt springen

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:

JavaScript
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:

HTML
<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:

HTML
<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

HTML
<div
  data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
HTML
<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].