Zum Inhalt springen

Timelines

Verwende tl, um Animationen zu verketten. Der GSAP-Adapter erstellt native Timelines, der Motion-Adapter erstellt Motion-Sequenzen. Die Beispiele unten verwenden GSAP. Informationen zu unterstützten Easing- und Timeline-Einstellungen findest du im Motion-Leitfaden.

Einfache Timeline

Füge tl hinzu, um einen Timeline-Container zu erstellen:

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>

Standardmäßig bezieht Glaze alle untergeordneten Elemente eines Elements mit Timeline-Deklaration in den Geltungsbereich der Timeline ein – du musst sie nicht explizit angeben.

Timeline-Standardwerte

Lege Standardwerte für die gesamte Timeline fest:

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

Bei einem Timeline-Element legt der Text nach tl die Optionen der GSAP-Timeline selbst fest. Ein einfacher Abschnitt key-value legt eine Option der obersten Ebene fest (repeat-1, yoyo-true), und key: gefolgt von durch senkrechte Striche getrennten Werten legt eine verschachtelte Option fest: defaults:ease-elastic|duration-4 wird zu defaults: { ease: "elastic", duration: 4 } und scrollTrigger:trigger-[&] zu scrollTrigger: { trigger: element }. Punktnotation wie scrollTrigger.trigger-[&] funktioniert nur innerhalb der Eigenschaften from: oder to: eines Elements.

Zeitsteuerung

Passe mit tl: an, wann untergeordnete Animationen starten:

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] bedeutet „3 Sekunden vor dem Ende der vorherigen Animation starten“ (Überlappung).

Übliche Zeitangaben:

  • tl:[+=1] – 1 Sekunde nach dem Ende des vorherigen starten
  • tl:[-=1] – 1 Sekunde vor dem Ende des vorherigen starten (Überlappung)
  • tl:[<] – gleichzeitig mit dem vorherigen starten

Responsive Timelines

Kombiniere Breakpoints mit 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>

Die Drehung findet immer statt, aber die horizontale Bewegung setzt erst auf großen Bildschirmen ein.

Benannte Timelines

Gib deiner Timeline einen Namen, damit du sie von überall aus referenzieren kannst:

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>

Verwende tl/name, um eine benannte Timeline zu erstellen, und tl:name, um ihr beizutreten.