Skip to content

Timelines

Use tl to chain animations. The GSAP adapter creates native timelines, and the Motion adapter creates Motion sequences. The examples below use GSAP; see the Motion guide for its supported easing and timeline settings.

Basic timeline

Add tl to create a timeline container:

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>

By design, Glaze incorporates all child elements of a timeline-declared element into the timeline's scope - you don't need to explicitly include them.

Timeline defaults

Set defaults for the whole timeline:

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

On a timeline element, the string after tl sets the options of the GSAP timeline itself. A plain key-value segment sets a top-level option (repeat-1, yoyo-true), and key: followed by pipe-separated values sets a nested one: defaults:ease-elastic|duration-4 becomes defaults: { ease: "elastic", duration: 4 }, and scrollTrigger:trigger-[&] becomes scrollTrigger: { trigger: element }. Dot notation such as scrollTrigger.trigger-[&] only works inside an element's from: or to: properties.

Timing control

Adjust when child animations start using 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] means "start 3 seconds before the previous animation ends" (overlap).

Common timing values:

  • tl:[+=1] - Start 1 second after previous ends
  • tl:[-=1] - Start 1 second before previous ends (overlap)
  • tl:[<] - Start at same time as previous

Responsive timelines

Combine breakpoints with timelines:

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>

The rotation always happens, but the horizontal movement only kicks in on large screens.

Named timelines

Give your timeline a name to reference it from anywhere:

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>

Use tl/name to create a named timeline, and tl:name to join it.