본문으로 건너뛰기

타임라인

애니메이션을 연결하려면 tl을 사용하세요. GSAP 어댑터는 기본 타임라인을 만들고, Motion 어댑터는 Motion 시퀀스를 만듭니다. 아래 예제에서는 GSAP을 사용합니다. 지원되는 이징 및 타임라인 설정은 Motion 가이드를 참조하세요.

기본 타임라인

타임라인 컨테이너를 만들려면 tl을 추가하세요:

HTML
<div data-animate="tl defaults:ease-elastic|duration-1">
  <div data-animate="to:rotate-360"></div>
  <div data-animate="to:rotate-360"></div>
</div>

Glaze은 타임라인으로 선언된 요소의 모든 하위 요소를 타임라인 범위에 포함하도록 설계되어 있어, 하위 요소를 명시적으로 지정할 필요가 없습니다.

타임라인 기본값

전체 타임라인에 적용할 기본값을 설정하세요:

HTML
<div data-animate="tl defaults:ease-elastic|duration-4 repeat-1 yoyo-true">
  ...
</div>

타임라인 요소에서 tl 뒤의 문자열은 GSAP 타임라인 자체의 옵션을 설정합니다. 일반 key-value 세그먼트는 최상위 옵션(repeat-1, yoyo-true)을 설정하고, key: 뒤에 파이프로 구분된 값을 지정하면 중첩 옵션을 설정합니다. 예를 들어 defaults:ease-elastic|duration-4은 defaults: { ease: "elastic", duration: 4 }이 되고, scrollTrigger:trigger-[&]은 scrollTrigger: { trigger: element }이 됩니다. scrollTrigger.trigger-[&]과 같은 점 표기법은 요소의 from: 또는 to: 속성 안에서만 작동합니다.

타이밍 제어

tl:을 사용해 하위 애니메이션의 시작 시점을 조정하세요:

HTML
<div data-animate="tl defaults:ease-elastic|duration-4">
  <div data-animate="to:rotate-360"></div>
  <div data-animate="tl:[-=3] to:rotate-360"></div>
</div>
HTML
<div
  class="grid gap-8"
  data-animate="tl defaults:ease-elastic|duration-4 scrollTrigger:trigger-[&]"
>
  <div
    class="h-20 w-20 rounded-xl bg-amber-500"
    data-animate="to:rotate-360"
  ></div>
  <div
    class="h-20 w-20 rounded-xl bg-green-500"
    data-animate="tl:[-=3] to:rotate-360"
  ></div>
</div>

tl:[-=3]은 "이전 애니메이션이 끝나기 3초 전에 시작"을 의미합니다(겹침).

일반적인 타이밍 값:

  • tl:[+=1] - 이전 애니메이션이 끝난 후 1초 뒤에 시작
  • tl:[-=1] - 이전 애니메이션이 끝나기 1초 전에 시작(겹침)
  • tl:[<] - 이전 애니메이션과 동시에 시작

반응형 타임라인

브레이크포인트와 타임라인을 결합하세요:

HTML
<div data-animate="tl defaults:ease-power2.inOut|duration-2">
  <div data-animate="to:rotate-360 @lg:to:xPercent-[50]"></div>
  <div data-animate="tl:[-=1] to:rotate-360 @lg:to:xPercent-[-50]"></div>
</div>
HTML
<div
  class="grid gap-8"
  data-animate="tl defaults:ease-power2.inOut|duration-2 scrollTrigger:trigger-[&]"
>
  <div
    class="h-20 w-20 rounded-xl bg-amber-500"
    data-animate="to:rotate-360 @lg:to:xPercent-[100]"
  ></div>
  <div
    class="h-20 w-20 rounded-xl bg-green-500"
    data-animate="tl:[-=1] to:rotate-360 @lg:to:xPercent-[-100]"
  ></div>
</div>

회전은 항상 실행되지만, 수평 이동은 큰 화면에서만 시작됩니다.

이름이 지정된 타임라인

타임라인에 이름을 지정해 어디서든 참조하세요:

HTML
<div data-animate="tl/main defaults:ease-power2.inOut|duration-2">
  <div data-animate="to:rotate-360"></div>
</div>

<!-- Somewhere else in the DOM -->
<div data-animate="tl:main-[-=1] to:scale-1.5">...</div>
HTML
<div class="grid w-full grid-cols-2 justify-items-center">
  <div
    class="grid gap-8"
    data-animate="tl/main defaults:ease-power2.inOut|duration-2 scrollTrigger:trigger-[&]"
  >
    <div
      class="h-20 w-20 rounded-xl bg-amber-500"
      data-animate="to:rotate-360"
    ></div>
    <div
      class="h-20 w-20 rounded-xl bg-green-500"
      data-animate="tl:[-=1] to:rotate-360"
    ></div>
  </div>
  <div
    class="tl grid gap-8"
    data-animate="tl:main-[-=1] [&>div]:to:rotate-360|stagger-0.25"
  >
    <div class="h-20 w-20 rounded-xl bg-rose-500"></div>
    <div class="h-20 w-20 rounded-xl bg-red-500"></div>
  </div>
</div>

tl/name으로 이름이 지정된 타임라인을 만들고 tl:name로 연결하세요.