Aller au contenu

Chronologies

Utilisez tl pour enchaîner les animations. L’adaptateur GSAP crée des timelines natives, et l’adaptateur Motion crée des séquences Motion. Les exemples ci-dessous utilisent GSAP ; consultez le guide Motion pour connaître les paramètres d’accélération et de timeline pris en charge.

Chronologie de base

Ajoutez tl pour créer un conteneur de chronologie :

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>

Par conception, Glaze intègre dans la portée de la chronologie tous les éléments enfants d’un élément déclaré comme chronologie ; vous n’avez pas besoin de les inclure explicitement.

Valeurs par défaut des timelines

Définissez des valeurs par défaut pour toute la chronologie :

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

Sur un élément de chronologie, la chaîne qui suit tl définit les options de la chronologie GSAP elle-même. Un segment simple key-value définit une option de premier niveau (repeat-1, yoyo-true), tandis que key: suivi de valeurs séparées par des barres verticales définit une option imbriquée : defaults:ease-elastic|duration-4 devient defaults: { ease: "elastic", duration: 4 }, et scrollTrigger:trigger-[&] devient scrollTrigger: { trigger: element }. La notation avec des points, comme scrollTrigger.trigger-[&], ne fonctionne que dans les propriétés from: ou to: d’un élément.

Contrôle du minutage

Ajustez le moment où les animations enfants commencent à l’aide de 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] signifie « commencer 3 secondes avant la fin de l’animation précédente » (chevauchement).

Valeurs de temporisation courantes :

  • tl:[+=1] - Démarre 1 seconde après la fin du précédent
  • tl:[-=1] - Démarre 1 seconde avant la fin du précédent (chevauchement)
  • tl:[<] - Démarre en même temps que le précédent

Chronologies adaptatives

Combinez les points de rupture avec les chronologies :

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 rotation se produit toujours, mais le déplacement horizontal ne s’active que sur les grands écrans.

Chronologies nommées

Donnez un nom à votre chronologie pour pouvoir la référencer depuis n’importe où :

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>

Utilisez tl/name pour créer une chronologie nommée et tl:name pour la rejoindre.