Hoppa till innehåll

ScrollTrigger

Det krävs ingen särskild syntax för att använda ScrollTrigger med Glaze. Eftersom den definieras i egenskapen scrollTrigger för animationsobjektet kan du använda punktnotation för att justera inställningarna.

Konfiguration

Registrera först ScrollTrigger med GSAP:

JavaScript
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"

gsap.registerPlugin(ScrollTrigger)

Initiera sedan Glaze som vanligt.

Användning

Lägg till egenskaperna scrollTrigger.* i animationen:

HTML
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>

[&] betyder ”använd det här elementet som utlösare” (samma som & i väljare).

På ett fristående element flyttar Glaze inställningarna scrollTrigger från animationen till tidslinjen som skapas för elementet, så att hela animationen styrs av rullning.

Inuti tidslinjer

Underordnade element till ett element med tl blir tweenar i en gemensam tidslinje, och Glaze behåller deras scrollTrigger-inställningar på tweenen. GSAP stöder inte ScrollTrigger på en tween som ligger inuti en tidslinje, så lägg den på tidslinjeelementet i stället och använd kolonformen för tidslinjeinställningar:

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>

Om du vill utlösa rullning för alla element samtidigt anger du det i tidslinjens standardvärden.

Vanliga alternativ

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>
Alternativ Funktion
scrollTrigger.trigger-[&] Elementet som utlöser animationen
scrollTrigger.start-[top_center] När den ska börja (elementets position + visningsområdets position)
scrollTrigger.end-[bottom_top] När den ska sluta
scrollTrigger.scrub-true Knyt animationens förlopp till rullningspositionen
scrollTrigger.markers-true Visa felsökningsmarkörer (användbara under utveckling)

Kom ihåg att använda understreck i stället för mellanslag i värden: [top_center], inte [top center].