العوامل

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

العوامل الحسابية‍

قم بإجراء العمليات الرياضية الأساسية.

• + (الجمع): يضيف رقمين أو يربط سلاسل نصية.
  • مثال: {{ 2 + 3 }} → 5
  • مثال: {{ "مرحبا، " + sessionUser.name }} → مرحبا، جون
• - (الطرح): يطرح رقماً من رقم آخر.
  • مثال: {{ 10 - 4 }} → 6
• * (الضرب): يضرب رقمين معاً.
  • مثال: {{ 5 * 3 }} → 15
• / (القسمة): يقسم رقمًا على رقم آخر.
  • مثال: {{ 10 / 2 }} → 5
  • ملاحظة: القسمة على الصفر ستؤدي إلى خطأ.
• % (الباقي): يُرجع باقي القسمة.
  • مثال: {{ 10 % 3 }} → 1
• ** (الأس): يرفع رقمًا لقوة رقم آخر.
  • مثال: {{ 2 ** 3 }} → 8

عوامل المقارنة‍

تُستخدم لمقارنة القيم وإرجاع صحيح أو خطأ.

• == (المساواة): يتحقق مما إذا كانت قيمتان متساويتين.
  • مثال: {{ 2 + 2 == 4 }} → صحيح
• != (عدم المساواة): يتحقق مما إذا كانت قيمتان غير متساويتين.
  • مثال: {{ sessionUser.stats.ideas != 0 }} → صحيح
• > (أكبر من): يتحقق مما إذا كانت القيمة اليسرى أكبر من اليمنى.
  • مثال: {{ sessionUser.stats.likes > 10 }} → صحيح
• >= (أكبر من أو يساوي): يتحقق مما إذا كانت القيمة اليسرى أكبر من أو تساوي اليمنى.
  • مثال: {{ 5 >= 5 }} → صحيح
• < (أقل من): يتحقق مما إذا كانت القيمة اليسرى أقل من اليمنى.
  • مثال: {{ 3 < 10 }} → صحيح
• <= (أقل من أو يساوي): يتحقق مما إذا كانت القيمة اليسرى أقل من أو تساوي اليمنى.
  • مثال: {{ sessionUser.stats.ideas <= 20 }} → صحيح

العوامل المنطقية

‍تُستخدم لدمج شروط متعددة.

• && (و AND): تُرجع صحيحًا إذا كان الشرطان كلاهما صحيحًا.
  • مثال: {{ sessionUser.stats.likes > 10 && sessionUser.stats.ideas > 5 }} → صحيح إذا تم استيفاء الشرطين.
• || (أو OR): تُرجع صحيحًا إذا كان أحد الشروط صحيحًا على الأقل.
  • مثال: {{ sessionUser.rank == 3000 || sessionUser.rank == 5000 }} → صحيح إذا كان المستخدم مشرفًا أو مالكًا.
• ! (نفي NOT): يعكس قيمة الحقيقة لشرط ما.
  • مثال: {{ !(2 + 2 == 5) }} → صحيح

‍العامل الشرطي

قد ترغب في أحيانٍ تنفيذ فروع شرطية من صيغك اعتمادًا على البيانات السياقية. على سبيل المثال، قد ترغب في:

• استخدام مفاتيح ترجمة مختلفة في وصف جمع أفكارك اعتمادًا على رتبة المستخدم الحالي.
• تعيين قيم مختلفة لفكرة في إجراء آلي اعتمادًا على ما إذا كان لديها أكثر من كمية محددة مثلاً في التعليقات.

يمكنك استخدام العامل الشرطي داخل تعبيراتك الديناميكية لتحقيق هذه الأمور. العامل الشرطي فريد من نوعه لأنه يقبل ثلاث معاملات.

له الهيكل التالي: <الشرط> ? <عند الصواب> : <عند الخطأ>

إليك مثال بسيط: {{ sessionUser.stats.likes > 10 ? "المساهم_الأبرز" : "مبتدئ" }}

يمكنك وضع أي شيء داخل فرعي العامل الشرطي، بما في ذلك متغيرات ترجمة مخصصة، أو صيغ معقدة متداخلة.

على سبيل المثال، قد ترغب في استخدام متغيرات ترجمة مخصصة مختلفة، اعتمادًا على رتبة المستخدم الحالي:

{{ sessionUser.rank >= 3000 ? (sessionUser.stats.ideas > 20 ? "مشرف فائق" : "مشرف") : "عضو" }}

عوامل التجميع

تُستخدم للتحكم في ترتيب العمليات عن طريق تجميع التعبيرات بأقواس ().

• مثال: {{ (2 + 3) * 4 }} → 20
• بدون أقواس: {{ 2 + 3 * 4 }} → 14
• ملاحظة: الضرب له الأولوية.

نصائح للتعامل مع الأخطاء في العوامل

• تجنب القسمة على الصفر: لتجنب الأخطاء عند القسمة على متغير قد يكون صفرًا، استخدم منطق التراجع مع دوال مثل MAX() أو العوامل الشرطية.
  • مثال: بدلاً من {{ 10 / variable }}، استخدم:{{ 10 / MAX(variable, 1) }} — لضمان أن المقسوم عليه لا يقل عن 1.
  • مثال باستخدام شرط: {{ variable != 0 ? 10 / variable : "غير معرف (قسمة على صفر)" }} — يعرض رسالة بديلة عند كون المقسوم عليه صفرًا.‍
• تحقق من الأقواس الخاصة بك: تأكد من إغلاق جميع الأقواس المفتوحة.

• استخدم العوامل المنطقية بحذر: تحقق جيدًا من الشروط لتجنب النتائج غير المتوقعة.

بإتقان العوامل، يمكنك إنشاء تعابير ديناميكية أكثر تعقيدًا وجاذبية، مما يمكن مساحة عملك من الاستجابة بذكاء للبيانات وتفاعلات المستخدم.