Przejdź do treści

ScrollTrigger

Nie musisz używać specjalnej składni, aby korzystać z ScrollTrigger z Glaze. Ponieważ jest zdefiniowane wewnątrz właściwości scrollTrigger obiektu animacji, możesz dostosować jego ustawienia za pomocą notacji kropkowej.

Konfiguracja

Najpierw zarejestruj ScrollTrigger za pomocą GSAP:

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

gsap.registerPlugin(ScrollTrigger)

Następnie zainicjuj Glaze jak zwykle.

Użycie

Dodaj do animacji właściwości scrollTrigger.*:

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

[&] oznacza „użyj tego elementu jako wyzwalacza” (tak samo jak & w selektorach).

W przypadku samodzielnego elementu Glaze przenosi ustawienia scrollTrigger z animacji na utworzoną dla tego elementu oś czasu, dzięki czemu przewijanie steruje całą animacją.

Wewnątrz osi czasu

Elementy potomne elementu tl są animacjami typu tween na wspólnej osi czasu, a Glaze pozostawia ich ustawienia scrollTrigger na poziomie tweena. GSAP nie obsługuje ScrollTrigger na tweenie zagnieżdżonym w osi czasu, dlatego umieść je na elemencie osi czasu, używając dwukropka do określenia jej ustawień:

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>

Aby przewijanie wyzwalało animację wszystkich elementów jednocześnie, ustaw to w domyślnych ustawieniach osi czasu.

Najczęściej używane opcje

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>
Opcja Działanie
scrollTrigger.trigger-[&] Element wyzwalający animację
scrollTrigger.start-[top_center] Kiedy rozpocząć (pozycja elementu + pozycja w oknie widoku)
scrollTrigger.end-[bottom_top] Kiedy zakończyć
scrollTrigger.scrub-true Powiązanie postępu animacji z pozycją przewijania
scrollTrigger.markers-true Wyświetlanie znaczników debugowania (pomocnych podczas tworzenia)

Pamiętaj, aby w wartościach używać podkreśleń zamiast spacji: [top_center], a nie [top center].