ScrollTrigger
ScrollTrigger을 Glaze에서 사용하는 데 특별한 구문은 필요하지 않습니다. 애니메이션 객체의 scrollTrigger 속성 안에 정의되어 있으므로 점 표기법으로 설정을 조정할 수 있습니다.
설정
먼저 GSAP에 ScrollTrigger을 등록하세요.
JavaScript
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"
gsap.registerPlugin(ScrollTrigger)
그런 다음 평소처럼 Glaze을 초기화하세요.
사용법
애니메이션에 scrollTrigger.* 속성을 추가하세요.
HTML
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>
[&]은 "이 요소를 트리거로 사용"한다는 뜻입니다(선택자의 &과 동일).
독립형 요소에서 Glaze은 애니메이션의 scrollTrigger 설정을 해당 요소에 생성하는 타임라인으로 옮기므로, 전체 애니메이션이 스크롤에 따라 진행됩니다.
타임라인 내부에서
tl 요소의 자식 요소는 공유 타임라인의 트윈이며, Glaze은 해당 요소의 scrollTrigger 설정을 트윈에 그대로 둡니다. GSAP은 타임라인 안에 중첩된 트윈의 ScrollTrigger을 지원하지 않으므로, 타임라인 요소에 타임라인 설정용 콜론 형식을 사용해 지정하세요.
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>
모든 요소에 한 번에 스크롤 트리거를 적용하려면 타임라인 기본값에 설정하세요.
일반 옵션
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>
| 옵션 | 기능 |
|---|---|
scrollTrigger.trigger-[&] |
애니메이션을 트리거하는 요소 |
scrollTrigger.start-[top_center] |
시작 시점(요소 위치 + 뷰포트 위치) |
scrollTrigger.end-[bottom_top] |
종료 시점 |
scrollTrigger.scrub-true |
애니메이션 진행률을 스크롤 위치에 연결 |
scrollTrigger.markers-true |
디버그 마커 표시(개발 중 유용) |
값에 공백 대신 밑줄을 사용하세요. [top_center]이 아니라 [top center]입니다.