ScrollTrigger
A ScrollTrigger használatához nincs szükség külön szintaxisra a Glaze esetében. Mivel az animációs objektum scrollTrigger tulajdonságában van meghatározva, pontozott jelöléssel módosíthatja a beállításait.
Beállítás
Először regisztrálja a ScrollTrigger elemet a GSAP használatával:
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"
gsap.registerPlugin(ScrollTrigger)
Ezután inicializálja a Glaze elemet a szokásos módon.
Használat
Adja hozzá a scrollTrigger.* tulajdonságokat az animációhoz:
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>
A [&] jelentése: „használja ezt az elemet indítóelemként” (ugyanaz, mint a & a szelektorokban).
Önálló elem esetén a Glaze áthelyezi az animáció scrollTrigger beállításait az elemhez létrehozott idővonalra, így a teljes animációt a görgetés vezérli.
Idővonalakon belül
A tl elem gyermekei egy közös idővonal tweenjei, a Glaze pedig a scrollTrigger beállításokat a tweenen hagyja. A GSAP nem támogatja a ScrollTrigger beállítást az idővonalba ágyazott tweenen, ezért helyezze azt az idővonal elemre, az idővonal-beállítások kettőspontos formáját használva:
<div data-animate="tl scrollTrigger:trigger-[&]|start-[top_center]">
<div data-animate="to:rotate-360"></div>
<div data-animate="to:rotate-360"></div>
</div>
Ha egyszerre minden elemet görgetéshez szeretne kötni, adja meg a az idővonal alapértelmezett beállításaiban.
Gyakori beállítások
<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>
| Beállítás | Mit csinál |
|---|---|
scrollTrigger.trigger-[&] |
Az animációt elindító elem |
scrollTrigger.start-[top_center] |
Mikor induljon (az elem helyzete + a nézetablak helyzete) |
scrollTrigger.end-[bottom_top] |
Mikor érjen véget |
scrollTrigger.scrub-true |
Az animáció előrehaladását a görgetési pozícióhoz köti |
scrollTrigger.markers-true |
Hibakeresési jelölők megjelenítése (fejlesztéskor hasznos) |
Ne felejtsen el szóközök helyett aláhúzásjeleket használni az értékekben: [top_center], nem pedig [top center].