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

ScrollTrigger

لا تحتاج إلى صياغة خاصة لاستخدام ScrollTrigger مع Glaze. وبما أنه معرّف داخل الخاصية scrollTrigger لكائن الحركة، يمكنك استخدام صياغة النقاط لضبط إعداداته.

الإعداد

أولًا، سجّل ScrollTrigger باستخدام GSAP:

JavaScript
import gsap from "gsap"
import ScrollTrigger from "gsap/ScrollTrigger"

gsap.registerPlugin(ScrollTrigger)

ثم هيّئ Glaze كالمعتاد.

الاستخدام

أضف خصائص scrollTrigger.* إلى الحركة:

HTML
<div data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]"></div>

تعني [&] «استخدم هذا العنصر كمُشغّل» (مثل & في المحددات).

في عنصر مستقل، تنقل Glaze إعدادات scrollTrigger من الحركة إلى المخطط الزمني الذي تنشئه لهذا العنصر، لتتحكم الحركة بأكملها بالتمرير.

داخل المخططات الزمنية

العناصر التابعة لعنصر tl هي تحريكات في مخطط زمني مشترك، وتُبقي Glaze إعدادات scrollTrigger على التحريك. لا يدعم GSAP استخدام ScrollTrigger على تحريك متداخل داخل مخطط زمني، لذا أضِفه إلى عنصر المخطط الزمني بدلًا من ذلك، باستخدام صيغة النقطتين لإعدادات المخطط الزمني:

HTML
<div data-animate="tl scrollTrigger:trigger-[&]|start-[top_center]">
  <div data-animate="to:rotate-360"></div>
  <div data-animate="to:rotate-360"></div>
</div>

لتشغيل كل عنصر بالتمرير دفعة واحدة، اضبطه في الإعدادات الافتراضية للمخطط الزمني.

الخيارات الشائعة

HTML
<div
  data-animate="from:opacity-0|y-50|scrollTrigger.trigger-[&]|scrollTrigger.start-[top_center]|scrollTrigger.end-[bottom_top]|scrollTrigger.scrub-true"
></div>
HTML
<div class="flex h-[50vh] items-center">
  <div
    class="h-20 w-20 rounded-xl bg-amber-500 sm:invisible"
    data-animate="from:autoAlpha-0|rotate-180|y-50|scrollTrigger.trigger-[&]|boxShadow-[0_0_100px_20px_orange]|scrollTrigger.scrub-true|scrollTrigger.start-[top_center]|scrollTrigger.end-[-=200]"
  ></div>
</div>
الخيار وظيفته
scrollTrigger.trigger-[&] العنصر الذي يطلق الحركة
scrollTrigger.start-[top_center] وقت البدء (موضع العنصر + موضع إطار العرض)
scrollTrigger.end-[bottom_top] وقت الانتهاء
scrollTrigger.scrub-true ربط تقدم الحركة بموضع التمرير
scrollTrigger.markers-true إظهار علامات التصحيح (مفيدة أثناء التطوير)

تذكّر استخدام الشرطة السفلية بدلًا من المسافات في القيم: [top_center] وليس [top center].