في هذه الصفحة

العوامل

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

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

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

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

  • + (الجمع): يجمع عددين أو يدمج سلسلتي نص.
    • مثال: {{ 2 + 3 }} ← 5
    • مثال: {{ "Hello, " + sessionUser.name }} → مرحبًا، 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

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

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

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

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

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

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

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

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

إليك مثالًا بسيطًا: {{ sessionUser.stats.likes > 10 ? "Top-contributor" : "Rookie" }}

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

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

{{ sessionUser.rank >= 3000 ? (sessionUser.stats.ideas > 20 ? "Super Admin" : "Admin") : "Member" }}

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

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

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

نصائح لمعالجة الأخطاء لعوامل التشغيل

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

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