انتقل إلى المحتوى

الخطوط الزمنية

استخدم 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] «ابدأ قبل انتهاء الحركة السابقة بثلاث ثوانٍ» (تداخل).

قيم التوقيت الشائعة:

  • tl:[+=1] - ابدأ بعد ثانية واحدة من انتهاء السابق
  • tl:[-=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 للانضمام إليه.