İçeriğe geç

ScrollTrigger

ScrollTrigger ile Glaze kullanmak için özel bir söz dizimi gerekmez. Animasyon nesnesinin scrollTrigger özelliğinde tanımlandığından, ayarlarını değiştirmek için nokta gösterimini kullanabilirsiniz.

Kurulum

Önce ScrollTrigger öğesini GSAP ile kaydedin:

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

gsap.registerPlugin(ScrollTrigger)

Ardından Glaze öğesini her zamanki gibi başlatın.

Kullanım

Animasyonunuza scrollTrigger.* özelliklerini ekleyin:

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

[&], “bu öğeyi tetikleyici olarak kullan” anlamına gelir (seçicilerdeki & ile aynıdır).

Bağımsız bir öğede Glaze, scrollTrigger ayarlarını animasyondan alıp o öğe için oluşturduğu zaman çizelgesine taşır; böylece tüm animasyon kaydırmayla yönetilir.

Zaman çizelgelerinin içinde

Bir tl öğesinin alt öğeleri ortak bir zaman çizelgesindeki ara animasyonlardır ve Glaze, scrollTrigger ayarlarını ara animasyonda bırakır. GSAP, zaman çizelgesinin iç içe yerleştirilmiş bir ara animasyonundaki ScrollTrigger öğesini desteklemez; bu nedenle zaman çizelgesi ayarları için iki nokta üst üste biçimini kullanarak ayarı zaman çizelgesi öğesine ekleyin:

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>

Tüm öğeleri aynı anda kaydırmayla tetiklemek için bunu zaman çizelgesi varsayılanlarında ayarlayın.

Yaygın seçenekler

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>
Seçenek Ne işe yarar
scrollTrigger.trigger-[&] Animasyonu tetikleyen öğe
scrollTrigger.start-[top_center] Ne zaman başlayacağı (öğe konumu + görünüm alanı konumu)
scrollTrigger.end-[bottom_top] Ne zaman biteceği
scrollTrigger.scrub-true Animasyon ilerlemesini kaydırma konumuna bağlar
scrollTrigger.markers-true Hata ayıklama işaretçilerini gösterir (geliştirme sırasında yararlı)

Değerlerde boşluk yerine alt çizgi kullanmayı unutmayın: [top_center], [top center] değil.