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:
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.*:
<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ń:
<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
<div
data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
<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].