跳转到正文

时间线

使用 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 加入该时间线。