ScrollTrigger
Non serve una sintassi speciale per usare ScrollTrigger con Glaze. Poiché è definito nella proprietà scrollTrigger dell’oggetto di animazione, potete usare la notazione con il punto per modificarne le impostazioni.
Configurazione
Per prima cosa, registrate ScrollTrigger con GSAP:
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"
gsap.registerPlugin(ScrollTrigger)
Poi inizializzate Glaze come di consueto.
Utilizzo
Aggiungete le proprietà scrollTrigger.* alla vostra animazione:
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>
[&] significa «usa questo elemento come trigger» (come & nei selettori).
Su un elemento autonomo, Glaze trasferisce le impostazioni scrollTrigger dall’animazione alla timeline che crea per quell’elemento, così l’intera animazione viene controllata dallo scorrimento.
Nelle timeline
I figli di un elemento tl sono tween in una timeline condivisa e Glaze mantiene le loro impostazioni scrollTrigger sul tween. GSAP non supporta un ScrollTrigger su un tween annidato in una timeline, quindi applicatelo all’elemento della timeline, usando la forma con i due punti per le impostazioni della timeline:
<div data-animate="tl scrollTrigger:trigger-[&]|start-[top_center]">
<div data-animate="to:rotate-360"></div>
<div data-animate="to:rotate-360"></div>
</div>
Per attivare lo scorrimento come trigger per tutti gli elementi contemporaneamente, impostatelo nei valori predefiniti della timeline.
Opzioni comuni
<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>
| Opzione | Cosa fa |
|---|---|
scrollTrigger.trigger-[&] |
Elemento che attiva l'animazione |
scrollTrigger.start-[top_center] |
Quando iniziare (posizione dell'elemento + posizione nel viewport) |
scrollTrigger.end-[bottom_top] |
Quando terminare |
scrollTrigger.scrub-true |
Collega l'avanzamento dell'animazione alla posizione di scorrimento |
scrollTrigger.markers-true |
Mostra indicatori di debug (utili durante lo sviluppo) |
Ricordatevi di usare i trattini bassi al posto degli spazi nei valori: [top_center], non [top center].