الدوال

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

ما هي الدوال؟

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

تُكتب الدوال داخل أقواس معقوفة مزدوجة {{ ... }} ويمكن دمجها مع متغيرات البيانات، والقيم الحرفية، والعوامل.

مثال: {{ ROUND(AVERAGE(sessionUser.stats.likes, 10)) }} - يحسب هذا المثال المتوسط بين إجمالي الإعجابات للمستخدم والعدد 10، ويقرب النتيجة إلى أقرب عدد صحيح.

دوال التلاعب بالنصوص

• UPPERCASE(text): يحول النص إلى أحرف كبيرة.
  • مثال: {{ UPPERCASE("hello world") }} → "HELLO WORLD" (نص)
• LOWERCASE(text): يحول النص إلى أحرف صغيرة.
  • مثال: {{ LOWERCASE("HELLO") }} → "hello" (نص)
• CAPITALIZE(text): يجعل أول حرف في السلسلة نصياً كبيراً.
  • مثال: {{ CAPITALIZE("ideanote") }} → "Ideanote" (نص)
• TRIM(text): يزيل الفراغات الزائدة من بداية ونهاية السلسلة النصية.
  • مثال: {{ TRIM(" idea collection ") }} → "idea collection" (نص)
• REPLACE(text, search, replace): يستبدل جزءاً من السلسلة النصية بسلسلة نصية أخرى.
  • مثال: {{ REPLACE("Innovation Hub", "Hub", "Center") }} → "Innovation Center" (نص)
• TRUNCATE(text, length): يقصر السلسلة النصية إلى طول محدد.
  • مثال: {{ TRUNCATE("Welcome to the innovation program!", 10) }} → "Welcome to..." (نص)
• CONCAT(...strings): يجمع عدة سلاسل نصية في سلسلة واحدة.
  • مثال: {{ CONCAT("Hello, ", "world") }} → "Hello, world" (نص)
• REPEAT(text, count): يكرر السلسلة النصية عدة مرات محددة.
  • مثال: {{ REPEAT("Hi! ", 3) }} → "Hi! Hi! Hi!" (نص)
• APPEND(text, suffix): يضيف لاحقة في نهاية السلسلة النصية.
  • مثال: {{ APPEND("hello", ", world") }} → "hello, world" (نص)
• PREPEND(text, prefix): يضيف بادئة في بداية السلسلة النصية.
  • مثال: {{ PREPEND("world", "hello, ") }} → "hello, world" (نص)
• STARTS_WITH(text, search): يُرجع ما إذا كانت السلسلة النصية تبدأ بسلسلة أخرى.
  • مثال: {{ STARTS_WITH("hello", "he") }} → true (منطقي)
• ENDS_WITH(text, search): يُرجع ما إذا كانت السلسلة النصية تنتهي بسلسلة أخرى.
  • مثال: {{ ENDS_WITH("hello", "lo") }} → true (منطقي)
• INCLUDES(text, search): يتحقق مما إذا كانت السلسلة النصية تحتوي على سلسلة أخرى.
  • مثال: {{ INCLUDES("hello", "ell") }} → true (منطقي)
• LENGTH(text): يُرجع طول النص.
  • مثال: {{ LENGTH("Ideas") }} → 5 (رقم)

دوال الرياضيات

• ABS(number): يُرجع القيمة المطلقة (غير السالبة) للرقم.
  • مثال: {{ ABS(-15) }} → 15 (رقم)
• ADD(...numbers): يُرجع مجموع قائمة من الأرقام.
  • مثال: {{ ADD(1, 2, 3) }} → 6 (رقم)
• SUBTRACT(number, subtrahend): يُرجع نتيجة طرح رقمين.
  • مثال: {{ SUBTRACT(10, 2) }} → 8 (رقم)
• MULTIPLY(number, multiplier): يُرجع نتيجة ضرب رقمين.
  • مثال: {{ MULTIPLY(2, 3) }} → 6 (رقم)
• DIVIDE(number, divisor): يقسم رقمًا على رقم آخر.
  • مثال: {{ DIVIDE(10, 2) }} → 5 (رقم)
• MOD(number, divisor): يُرجع باقي قسمة رقمين.
  • مثال: {{ MOD(10, 3) }} → 1 (رقم)
• ROUND(number): يقرب الرقم إلى أقرب عدد صحيح.
  • مثال: {{ ROUND(4.7) }} → 5 (رقم)
• CEIL(number): يُرجع أصغر عدد صحيح أكبر من أو يساوي الرقم.
  • مثال: {{ CEIL(1.5) }} → 2 (رقم)
• FLOOR(number): يُرجع أكبر عدد صحيح أقل من أو يساوي الرقم.
  • مثال: {{ FLOOR(1.5) }} → 1 (رقم)
• MAX(...numbers): يُرجع أكبر رقم في القائمة.
  • مثال: {{ MAX(10, 20, 5) }} → 20 (رقم)
• MIN(...numbers): يُرجع أصغر رقم في القائمة.
  • مثال: {{ MIN(10, 20, 5) }} → 5 (رقم)
• POW(number, exponent): يُرجع نتيجة رفع رقم إلى قوة رقم آخر.
  • مثال: {{ POW(2, 3) }} → 8 (رقم)
• AVERAGE(...numbers): يُرجع متوسط قائمة من الأرقام.
  • مثال: {{ AVERAGE(1, 2, 3) }} → 2 (رقم)

دوال التنسيق والأدوات

• FORMAT(value): يُنسق قيمة (مثل رقم أو تاريخ) بناءً على تفضيلات المستخدم.
  • مثال: {{ FORMAT(10000) }} → "10,000" (نص)
• PREFIX(text, prefix): يضيف بادئة في بداية السلسلة النصية.
  • مثال: {{ PREFIX("world", "hello, ") }} → "hello, world" (نص)
• SUFFIX(text, suffix): يضيف لاحقة في نهاية السلسلة النصية.
  • مثال: {{ SUFFIX("hello", ", world") }} → "hello, world" (نص)

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

1. تحقق من القيم null: تأكد من وجود المتغيرات التي تستخدمها.
2. تجنب القسمة على صفر: استخدم MAX لضمان أن المقسومات ليست صفرًا أبدًا، على سبيل المثال بكتابة {{ DIVIDE(10, MAX(value, 1)) }}.
3. طابق الأقواس: تأكد من تطابق جميع الأقواس في الدوال والشرطيات.
4. راجع رسائل الخطأ: تحويم المؤشر فوق قيمة "لم يتم حسابها" في مساحة عملك يمكن أن يوفر أدلة عن السبب الأساسي.

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