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

المحددات

بشكل افتراضي، يبحث Glaze عن العناصر ذات السمة data-animate ويبني الحركة استنادًا إلى قيمة تلك السمة. تغطي هذه الصفحة الخيارات الثلاثة التي تغيّر العناصر التي يقرأها Glaze، وهي dataAttribute وclassName وelement، بالإضافة إلى محددات الأقواس التي توجّه الحركة إلى عناصر أخرى. وترد تفاصيل الأدوات المساعدة داخل السلسلة في الصياغة.

كيفية العثور على العناصر

عند تشغيل glaze()، ثم مجددًا مع كل عملية refresh() أو إعادة بناء في وضع المراقبة، يجتاز كل العناصر داخل الجذر ويحتفظ بالعناصر التي تحمل السمة المُعدّة، أو التي تحمل في وضع الفئات فئة ذات البادئة المُعدّة. ويُحتسب عنصر الجذر نفسه أيضًا إذا كان يحمل إحداها. وتُقرأ العناصر حسب ترتيب المستند.

يحصل كل عنصر يُعثر عليه بهذه الطريقة على مخطط زمني خاص به، ما لم يكن داخل عنصر tl أو مرتبطًا بعنصر كهذا عبر tl:<id>. في هذه الحالة، يُضاف إلى ذلك المخطط الزمني. راجع المخططات الزمنية لمعرفة كيفية عمل التجميع.

سمة مخصصة

استخدم سمة بيانات مختلفة:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  dataAttribute: "data-move",
})

سيبحث Glaze الآن عن data-move بدلًا من data-animate:

HTML
<div data-move="from:opacity-0"></div>

يستبدل الخيار السمة بدلًا من إضافة سمة أخرى. مع الإعداد أعلاه، يتم تجاهل العنصر الذي لا يزال يحمل data-animate. استخدمه عندما يقرأ نص برمجي آخر في الصفحة data-animate بالفعل، أو عندما تريد أن تسمّي العلامات السمة باسم مشروعك.

في وضع المراقبة، يراقب Glaze السمة المضبوطة، لذا يؤدي تغيير قيمة data-move على عنصر إلى جدولة إعادة بنائه.

الصياغة المعتمدة على الأصناف

هل تفضل الأصناف على سمات البيانات؟ فعّل وضع الأصناف:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  className: "animate",
})

يمكنك الآن كتابة الحركات كأصناف:

HTML
<div class="animate-from:opacity-0|duration-1"></div>

يناسب هذا الأمر حال استخدامك بالفعل CSS الذي يعتمد على الأدوات المساعدة أولًا ورغبتك في أن تبدو الرسوم المتحركة مشابهة له. ويفيد وضع الأصناف أيضًا عندما يتيح لك نظام القوالب إضافة أصناف إلى عنصر، لكنه لا يتيح إضافة سمات اعتباطية.

يقرأ Glaze كل صنف يبدأ بالبادئة متبوعة بشرطة (animate- هنا) ويزيل ذلك الجزء. وتُترك الأصناف التي لا تبدأ بالبادئة كما هي، بحيث يمكن أن تتجاور أصناف الرسوم المتحركة وأصناف التنسيق على العنصر نفسه. ويمكنك تقسيم رسم متحرك على عدة أصناف:

HTML
<div class="card animate-from:opacity-0 animate-from:y-24"></div>

تقبل الأصناف المتجاوبة نقطة التوقف بعد البادئة أو قبلها. لا يعمل كلا المثالين إلا عند تطابق lg نقطة التوقف:

HTML
<div class="animate-@lg:from:opacity-0"></div>
<div class="@lg:animate-from:opacity-0"></div>

تعمل الإعدادات المسبقة بالطريقة نفسها في الأصناف، على سبيل المثال animate-preset-fadeIn.

لا يعطّل وضع الأصناف سمة البيانات. عندما تكون السمتان موجودتين على عنصر، يدمجهما Glaze في سلسلة واحدة: قيمة السمة أولًا، ثم الأصناف ذات البادئة بحسب ترتيب ظهورها في السمة class.

HTML
<div
  class="animate-from:opacity-0 animate-@lg:from:y-50"
  data-animate="from:duration-1"
></div>

يتحرك هذا العنصر من opacity: 0 على مدى ثانية واحدة بكل الأحجام، ويتحرك أيضًا من y: 50 عند تطابق lg. وبما أن السلاسل تُدمج، تنطبق القاعدة نفسها كما في السلسلة الواحدة: عندما يضبط جزآن الخاصية نفسها، تكون الغلبة للجزء اللاحق. هنا تتغلب قيمة الصنف على قيمة السمة في x:

HTML
<div class="animate-to:x-100" data-animate="to:x-50|y-20"></div>

يتحرك العنصر إلى x: 100 وy: 20.

عند تفعيل watch في وضع الفئات، يراقب Glaze أيضًا تغييرات class. تؤدي إضافة فئة animate- إلى عنصر، أو تغيير فئات عنصر Glaze يقرأها أو يحرّكها بالفعل، إلى جدولة إعادة البناء. وداخل عنصر ذي محدد نسبي، تؤدي تغييرات الفئات على العناصر التابعة له إلى ذلك أيضًا، لأنها قد تغيّر العناصر التي يطابقها المحدد. أما تغييرات الفئات على العناصر الأخرى فلا تؤدي إلى ذلك، ويشمل هذا العناصر الأسلاف للعناصر المتحركة؛ لذا فإن تبديل فئة الوضع الداكن على <html> أو فئة قفل التمرير على <body> لا يؤثر في الرسوم المتحركة الجارية. كذلك لا يُكتشف تغيير الفئة الذي يجعل عنصرًا يطابق محددًا عامًا حديثًا؛ استدعِ refresh() بعده.

يبحث Glaze في document بأكمله افتراضيًا. مرّر element لتحريك العناصر داخل حاوية فقط:

JavaScript
glaze({
  lib: { gsap: { core: gsap } },
  element: document.querySelector("#app"),
})

يقبل element عنصرًا من نوع Element أو Document. وهو يقيّد ثلاثة أمور:

  • لا يجري البحث عن أدوات الرسوم المتحركة إلا في العنصر الجذر وأبنائه. ويتم تجاهل العناصر في مواضع أخرى من الصفحة، حتى إذا كانت تحمل data-animate.
  • لا يراقب وضع المراقبة إلا التغييرات داخل الجذر.
  • ينظّف destroy() ما أنشأه هذا المثيل فقط، لتحتفظ الأجزاء الأخرى من الصفحة برسومها المتحركة.

لذلك يكون element الخيار الأنسب لأطر عمل المكونات. أنشئ مثيلًا لكل مكوّن مركّب باستخدام عنصر الجذر للمكوّن، واستدعِ destroy() عند إلغاء تركيبه، كما هو موضح في التحديث والتنظيف. امنح المثيلات المنفصلة جذورًا لا تتداخل؛ فالعنصر الموجود داخل جذرين تحرّكه كلا المثيلين.

استهداف عناصر أخرى

تحدد الخيارات أعلاه العناصر التي يقرأها Glaze. أما محدد الأقواس في بداية مقطع فيحدد العناصر التي يُطبّق عليها الرسم المتحرك. وإذا لم يوجد محدد، يستهدف الرسم المتحرك العنصر الذي يحمل الأدوات المساعدة.

المحددات النسبية

يُحلّ المحدد الذي يبدأ بـ & نسبةً إلى العنصر نفسه، حيث تشير & إلى ذلك العنصر. ويُستعلم عنه باستخدام querySelectorAll، لذا يمكنه مطابقة عدة عناصر:

HTML
<ul data-animate="[&>li]:from:opacity-0|y-20|stagger-0.1">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
</ul>

يطابق [&>li] أبناء li المباشرين. وتباعد قيمة stagger أوقات البدء بمقدار 0.1 ثانية. استخدم هذا عندما ينبغي لعنصر واحد التحكم في حركة قائمة أو شبكة أو مجموعة من الأبناء، دون إضافة سمة إلى كل ابن.

اكتب المسافات على هيئة شرطات سفلية. يصبح [&_p] هو & p ويطابق كل p داخل العنصر مهما كان العمق:

HTML
<article data-animate="[&_p]:from:opacity-0|stagger-0.2">
  <p>First paragraph</p>
  <div><p>Nested paragraph</p></div>
</article>

تتحول كل شرطة سفلية في المحدد إلى مسافة، لذلك لا يمكن مطابقة اسم صنف يحتوي على شرطة سفلية بهذه الطريقة.

يُحلّ [&] بمفرده إلى العنصر نفسه. ويُستخدم غالبًا كقيمة، مثل scrollTrigger.trigger-[&] في ScrollTrigger وافتراضيات الخط الزمني.

المحددات العامة

يُمرّر المحدد الذي لا يتضمن & إلى محرك الرسوم المتحركة كسلسلة نصية. ويحلّ كل من GSAP وMotion المحدد نسبةً إلى المستند كله، لا إلى العنصر أو الجذر element:

HTML
<h2 data-animate="[.badge]:from:opacity-0|scale-0.5|duration-0.3">Inbox</h2>
<span class="badge">3</span>

يحرّك هذا كل .badge في الصفحة أينما كان. فضّل المحددات النسبية داخل المكونات القابلة لإعادة الاستخدام، لأن المحدد العام يطابق أيضًا نسخ المكوّن الموجودة في مواضع أخرى من الصفحة.

الحدود

لكل عنصر هدف واحد. عندما يحتوي عدد من المقاطع على محدد، يُطبّق المحدد الأخير على جميع حالات العنصر. هنا يُطبّق كل من from وto على p، لا على h1:

HTML
<div data-animate="[&>h1]:from:opacity-0 [&>p]:to:x-20">
  <h1>Title</h1>
  <p>Text</p>
</div>

لتحريك مجموعتين على نحو مختلف، ضع الأدوات المساعدة على الأبناء أنفسهم، أو اجمعهم في خط زمني.

ينتهي المحدد عند أول ]، لذا لا تُدعم المحددات التي تحتوي على أقواس، مثل محددات السمات كـ [&>[data-item]]. استخدم محدد صنف أو عنصر بدلًا من ذلك.

تُركّب المحددات مع نقاط التوقف بالترتيب الموضح في الصياغة، على سبيل المثال @lg:[&>div]:from:opacity-0.