Vai al contenuto

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:

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

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

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>

Per attivare lo scorrimento come trigger per tutti gli elementi contemporaneamente, impostatelo nei valori predefiniti della timeline.

Opzioni comuni

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>
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].