Vai al contenuto

Timeline

Usate tl per concatenare le animazioni. L’adattatore GSAP crea timeline native, mentre l’adattatore Motion crea sequenze Motion. Gli esempi seguenti usano GSAP; consultate la guida di Motion per le impostazioni supportate di easing e timeline.

Timeline di base

Aggiungete tl per creare un contenitore per la timeline:

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>

Per progettazione, Glaze include nella timeline tutti gli elementi figli di un elemento dichiarato come timeline: non è necessario aggiungerli esplicitamente.

Valori predefiniti della timeline

Impostate i valori predefiniti per l'intera timeline:

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

In un elemento timeline, la stringa dopo tl imposta le opzioni della timeline GSAP stessa. Un segmento semplice key-value imposta un'opzione di primo livello (repeat-1, yoyo-true), mentre key: seguito da valori separati da barre verticali ne imposta una annidata: defaults:ease-elastic|duration-4 diventa defaults: { ease: "elastic", duration: 4 } e scrollTrigger:trigger-[&] diventa scrollTrigger: { trigger: element }. La notazione con il punto, come scrollTrigger.trigger-[&], funziona solo all'interno delle proprietà from: o to: di un elemento.

Controllo dei tempi

Regolate il momento di avvio delle animazioni figlie usando 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] significa «inizia 3 secondi prima della fine dell'animazione precedente» (sovrapposizione).

Valori di temporizzazione comuni:

  • tl:[+=1] - Inizia 1 secondo dopo la fine della precedente
  • tl:[-=1] - Inizia 1 secondo prima della fine della precedente (sovrapposizione)
  • tl:[<] - Inizia nello stesso momento della precedente

Timeline responsive

Combinate i punti di interruzione con le timeline:

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>

La rotazione avviene sempre, mentre il movimento orizzontale si attiva solo sugli schermi grandi.

Timeline con nome

Assegnate un nome alla timeline per richiamarla da qualsiasi punto:

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>

Usate tl/name per creare una timeline con nome e tl:name per collegarvi a essa.