Ga naar de inhoud

ScrollTrigger

Er is geen speciale syntaxis nodig om ScrollTrigger met Glaze te gebruiken. Omdat dit binnen de eigenschap scrollTrigger van het animatieobject is gedefinieerd, kun je de instellingen aanpassen met puntnotatie.

Instellen

Registreer eerst ScrollTrigger met GSAP:

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

gsap.registerPlugin(ScrollTrigger)

Initialiseer daarna Glaze zoals gewoonlijk.

Gebruik

Voeg scrollTrigger.*-eigenschappen toe aan je animatie:

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

[&] betekent 'gebruik dit element als trigger' (hetzelfde als & in selectors).

Bij een zelfstandig element verplaatst Glaze de instellingen van scrollTrigger van de animatie naar de tijdlijn die voor dat element wordt aangemaakt, zodat de hele animatie door scrollen wordt aangestuurd.

Binnen tijdlijnen

Kinderen van een element met tl zijn tweens in een gedeelde tijdlijn, en Glaze laat hun instellingen van scrollTrigger op de tween staan. GSAP ondersteunt geen ScrollTrigger op een tween binnen een tijdlijn. Plaats het daarom op het tijdlijnelement en gebruik de dubbelepuntnotatie voor tijdlijninstellingen:

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 alle elementen tegelijk door scrollen te laten activeren, stel je dit in bij de standaardinstellingen van de tijdlijn.

Veelgebruikte opties

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>
Optie Wat het doet
scrollTrigger.trigger-[&] Element dat de animatie activeert
scrollTrigger.start-[top_center] Wanneer de animatie start (elementpositie + viewportpositie)
scrollTrigger.end-[bottom_top] Wanneer de animatie eindigt
scrollTrigger.scrub-true Koppelt de voortgang van de animatie aan de scrollpositie
scrollTrigger.markers-true Toont debugmarkeringen (handig tijdens ontwikkeling)

Gebruik underscores in plaats van spaties in waarden: [top_center], niet [top center].