الدوال

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

ما هي الدوال؟

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

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

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

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