العوامل

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

عوامل التشغيل الحسابية‍

تُجري عمليات رياضية أساسية.

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

عوامل التشغيل للمقارنة‍

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

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

عوامل التشغيل المنطقية

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

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

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

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

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

يمكنك استخدام عامل التشغيل الشرطي داخل تعبيراتك الديناميكية لإنجاز هذه الأمور. عامل التشغيل الشرطي مميز لأنه يقبل ثلاثة عوامل.

يحتوي على الهيكل التالي: <condition> ? <when-true> : <when-false>

إليك مثال بسيط: {{ 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 : "غير معرف (القسمة على صفر)" }} — يعرض رسالة احتياطية عندما يكون المقسوم عليه صفرًا.‍
• تحقق من أقواسك: تأكد من إغلاق جميع الأقواس المفتوحة.

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

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