القيم الحرفية وأنواع البيانات

القيم الحرفية وأنواع البيانات

تدعم التعبيرات الديناميكية أنواعًا مختلفة من المُعطيات وأنواع البيانات التي تعزز مرونة وتفاعلية مساحة عملك.

المُعطيات المدعومة

يساعدك فهم المُعطيات المدعومة على استخدام قيم مباشرة في التعبيرات، مثل الأرقام والنصوص والقيم المنطقية والقيم الفارغة (null)، لإنشاء حسابات ديناميكية ودقيقة أو عرض المحتوى.

• numbers: يمكنك استخدام الأعداد العشرية الخام مباشرةً في تعبيراتك.
  • أمثلة:{{ 2 + 2 }}
{{ 2.5 + 3 }}
{{ 2.33 * sessionUser.stats.likes }}

• text: يمكنك استخدام السلاسل النصية الحرفية في تعبيراتك بإحاطتها بعلامتي اقتباس.
  • علامات الاقتباس المدعومة:
    • علامات الاقتباس المزدوجة: "Hello"
    • علامات الاقتباس الفردية: 'Hello'
    • علامات الاقتباس المزدوجة المتعرجة: “Hello”
• booleans: يمكن استخدام القيم المنطقية true وfalse مباشرةً.
  • أمثلة:{{ true }}
{{ false }}

• null: تمثّل غياب قيمة.
  • أمثلة:{{ null }}

• undefined: تمثّل غياب قيمة، على غرار null.
  • أمثلة:{{ undefined }}

  • ملاحظة: يُدعَم كل من undefined وnull للتوافق مع أعراف البرمجة.

أنواع البيانات المدعومة

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

• date: طابع زمني يمثّل تاريخًا ووقتًا محددين.
  • مثال:2025-01-09T22:46:24.872Z

• boolean: تمثّل القيمتين true أو false.
  • مثال:true

• number: عدد عشري.
  • مثال:125

• text: سلسلة نصية.
  • مثال:"Hello, World!"

• uuid: سلسلة نصية لمعرّف فريد عالميًا (UUID).
  • مثال:"590ff486-aa05-468e-839c-e3fe2548fed5"

• json: سجل يحتوي على بيانات منظّمة في أزواج من المفاتيح والقيم.
  • مثال:{"a": 1, "b": 2}

• unknown: تمثّل بيانات من نوع غير معروف.
  • مثال:غير متوفر
• file: يمثل كائن ملف.
  • مثال:File { filename: "screenshot.jpeg" }
• user_rank: رتبة المستخدم.
  • مثال:2000
  • القيم المحتملة:
    • 1000 (ضيف)
    • 2000 (عضو)
    • 3000 (مسؤول)
    • 5000 (مالك)
• locale: سلسلة لغة بتنسيق BCP 47.
  • مثال:"en"
• review_result: نتيجة المراجعة.
  • القيم المحتملة:
    • "مقبول"
    • "مرفوض"
• mission_status: حالة مجموعة الأفكار.
  • القيم المحتملة:
    • "قيد الانتظار"
    • "نشط"
    • "منتهٍ"
• device_kind: نوع الجهاز.
  • القيم المحتملة:
    • "سطح المكتب"
    • "هاتف محمول"
    • "جهاز لوحي"
• activity_kind: نوع النشاط.
  • القيم المحتملة:
    • "إنشاء فكرة"
    • "إنشاء توسيع فكرة"
    • "إنشاء مهمة"
    • "إنشاء علامة"
    • "إنشاء جمع أفكار"
    • (والمزيد)
• chart_kind: نوع المخطط.
  • القيم المحتملة:
    • "شريطي"
    • "خطي"
    • "دائري"
    • "لوحة النتائج"
    • "مخطط س-ص"
    • "قائمة"
    • "تكرار الكلمات"
    • "خريطة"
    • "قمعي"
    • "مخطط راداري"
• status_kind: فئة الحالة.
  • القيم المحتملة:
    • "نشط"
    • "مكتمل"
    • "مؤرشف"
• like_kind: يحدد ما إذا كان «الإعجاب» مرتبطًا بفكرة أم بتعليق.
  • القيم المحتملة:
    • "فكرة"
    • "تعليق"
• phase_kind: نوع مرحلة في عملية الأفكار.
  • القيم المحتملة:
    • "مراجعة"
    • "تطوير"
    • "تقييم"
    • "تطبيق"
    • "توسيع"
    • "تم"
• media_kind: نوع الوسائط.
  • القيم المحتملة:
    • "فيديو"
    • "صورة"
    • "مقطع صوتي"
    • "خط مخصص"
    • "أيقونة"
    • "مستند"
• invitation_status: حالة دعوة المستخدم.
  • القيم المحتملة:
    • "مدعو"
    • "مفتوح"
    • "مقبول"
• idea_field_kind: نوع حقل نموذج في مجموعة الأفكار.
  • القيم المحتملة:
    • "نص قصير"
    • "نص طويل"
    • "مرفقات"
    • "رقمي"
    • "علامة اختيار"
    • "شريط تمرير"
    • "زر راديو"
    • "تحديد"
    • "تاريخ ووقت"
    • "رمز"
    • "اختيار صورة"
    • "نقاط"
    • "مستخدم"
    • "ثابت"
• mention_kind: نوع @mention.
  • القيم المحتملة:
    • "تعليق"
    • "مثيل حقل الفكرة" (يمثل جزءًا من فكرة أو إدخال نموذج)
• id<entity>: سلسلة UUID تتوافق مع كائن فريد لكيان محدد.
  • مثال:"27ce21c9-a174-4c34-becc-f1068426f36a"

• ref<entity>: مرجع إلى كائن كامل لنوع محدد من الكيانات.
  • مثال:{ "_entity": "comment", "id": "93f970de-334c-423e-be0a-f0cf84c3da3b", "createdAt": "2025-01-09T23:05:17.042Z" }


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