Siirry sisältöön

ScrollTrigger

ScrollTriggern käyttämiseen Glazen kanssa ei tarvita erityistä syntaksia. Koska se määritellään animaatio-olion scrollTrigger-ominaisuudessa, sen asetuksia voi muuttaa piste-merkinnällä.

Määritys

Rekisteröi ensin ScrollTrigger komennolla GSAP:

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

gsap.registerPlugin(ScrollTrigger)

Alusta sitten Glaze tavalliseen tapaan.

Käyttö

Lisää animaatioosi scrollTrigger.*-ominaisuudet:

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

[&] tarkoittaa "käytä tätä elementtiä laukaisimena" (sama kuin valitsimien &).

Erillisessä elementissä Glaze siirtää scrollTrigger-asetukset animaatiosta kyseiselle elementille luotavalle aikajanalle, jolloin vieritys ohjaa koko animaatiota.

Aikajanojen sisällä

tl-elementin lapset ovat tween-animaatioita yhteisellä aikajanalla, ja Glaze jättää niiden scrollTrigger-asetukset tween-animaatioon. GSAP ei tue ScrollTrigger-asetusta aikajanan sisäkkäisessä tween-animaatiossa, joten lisää se aikajanaelementtiin. Käytä aikajanan asetuksissa kaksoispistesyntaksia:

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>

Jos haluat käynnistää vierityksen kaikissa elementeissä yhtä aikaa, määritä se aikajanan oletusarvoissa.

Yleiset asetukset

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>
Asetus Toiminto
scrollTrigger.trigger-[&] Animaation käynnistävä elementti
scrollTrigger.start-[top_center] Milloin aloitetaan (elementin sijainti + näkymäalueen sijainti)
scrollTrigger.end-[bottom_top] Milloin lopetetaan
scrollTrigger.scrub-true Animaation etenemisen linkittäminen vierityssijaintiin
scrollTrigger.markers-true Virheenjäljitysmerkkien näyttäminen (hyödyllistä kehitystyössä)

Muista käyttää arvoissa välilyöntien sijaan alaviivoja: [top_center], ei [top center].