مقدمة للتعبيرات الديناميكية
تتيح التعبيرات الديناميكية لك إنشاء محتوى مخصص وقائم على البيانات في مساحة العمل الخاصة بك. عن طريق دمج متغيرات البيانات، والترجمات المخصصة، والصيغ، يمكنك جعل المحتوى الخاص بك أكثر ديناميكية وتكيفًا مع جمهورك.
على سبيل المثال، يمكنك عرض رسالة مخصصة عن طريق كتابة:
"مرحبًا بعودتك، {{ sessionUser.name }}!"
هذا يقوم بجلب اسم المستخدم مباشرةً إلى الرسالة.
للسماح لنظامنا بتعبئة البيانات ولتمييزها بصريًا عن المحتوى الآخر، يتم دائمًا إحاطة التعبيرات الديناميكية بأقواس معقوفة مزدوجة: {{ ... }}.
كتابة أول تعبير ديناميكي لك
- انتقل إلى حقل نص يُسمح فيه بالتعبيرات (مثل سؤال جمع الأفكار).
- اكتب { لإظهار قائمة بالمتغيرات والدوال المتاحة.
- اختر اقتراحًا أو اكتب تعبيرك الخاص.
- أضف عوامل التشغيل والدوال حسب الحاجة.
- انقر خارج الحقل لرؤية تعبيرك الديناميكي قيد التنفيذ.
سيقوم العديد من حقول النص بحساب وعرض نتيجة تقييم جميع التعبيرات الديناميكية بداخلها فور فقدانها التركيز، بحيث تكون بالنسبة لك ولبياناتك الخاصة. تحقق مما إذا كنت تحصل على النتيجة التي تتوقعها. ولا تقلق، لم تفقد أي شيء كتبته - إذا نقرت على حقل النص مرة أخرى، سترى تعبيراتك الديناميكية تظهر مجددًا، ويمكنك الاستمرار في تحريرها.
أنواع التعبيرات الديناميكية
تتكون التعبيرات الديناميكية من مكونات مختلفة تعمل معًا لعرض نتائج مخصصة أو محسوبة.
متغيرات البيانات
متغيرات البيانات تمثل بيانات خاصة بمساحة العمل الخاصة بك، مثل أسماء المستخدمين، وعدد الأفكار، أو قيم النماذج.
- مثال:
{{sessionUser.name}}قد يعرض "جون دو".
متغيرات الترجمة المخصصة
متغيرات الترجمة المخصصة هي مفاتيح تخصيص محلية يمكنك إنشاؤها واستخدامها عبر منصتك لعرض المحتوى عبر لغات متعددة. عند استخدامها، وبناءً على اللغة التي ضبطها المستخدم الزائر في ملفه الشخصي، ستعرض المحتوى بلغة المستخدم إذا كنت قد عرفت ترجمة لتلك اللغة.
- مثال:
{{translate:custom.greeting}}يعرض نسخة مترجمة من نص التحية الخاص بك.
الدوال
الدوال تقوم بإجراءات مثل تحويل البيانات أو إجراء الحسابات. في القائمة، ستظهر توقيعًا لما هي الوسائط التي يجب تمريرها إليها، فضلاً عن أنواع البيانات المتوقعة. على سبيل المثال، دالة UPPERCASE() تتوقع استقبال نص. بعد ذلك، ستعرض وصفًا لما تفعله الدالة، بالإضافة إلى مثال لكيفية استخدامها.
- مثال:
{{ UPPERCASE(sessionUser.name) }}تحول اسم المستخدم إلى أحرف كبيرة.
العوامل
العوامل تُستخدم للحسابات والمقارنات.
- حسابية:
+,-,*,/ - منطقية:
&&(و)،||(أو) - مقارنة:
==,!=,>,< - شرطية:
? - مثال:
{{ sessionUser.stats.likes > 10 ? \"المساهم الأعلى\" : \"مبتدئ\" }}يعرض "المساهم الأعلى" إذا تجاوزت الإعجابات 10، وإلا "مبتدئ."
القيم الحرفية
القيم الحرفية أو "القيم الخام"، مثل الأعداد، والنصوص، أو القيم البوليانية، يمكن استخدامها بحرية داخل التعبير الديناميكي أيضاً.
- مثال:
{{ 5 }}أو{{ \"مرحبًا بالعالم!\" }}أو{{ true }}
معالجة الأخطاء
بسبب المرونة الكبيرة التي توفرها التعبيرات الديناميكية، فإنها قد تتعرض للكسر بسهولة، وأحيانًا بطرق قد لا تتوقعها. على سبيل المثال، قد ينتهي بك الأمر إلى:
- قسمة رقم على صفر.
- نسيان قوس إغلاق في مكان ما في التعبير الخاص بك.
- الإشارة إلى متغير ترجمة مخصص غير موجود (أو محذوف).
- محاولة رفع قيم غير نصية (مثل رقم) إلى الأحرف الكبيرة عن طريق الخطأ.
لحسن الحظ، إذا وجدت نفسك في أوضاع كهذه، فإن التعبيرات الديناميكية التي لم يمكن حسابها بشكل صحيح يمكن التعرف عليها بسهولة، وستُظهر لك بالضبط أين وما هي المشكلة عند المرور فوقها.
إليك بعض الأشياء التي يجب أخذها في الاعتبار أثناء كتابة التعبيرات الديناميكية لتقليل احتمال وقوع أخطاء:
- تأكد من عد عدد الأقواس التي تستخدمها، خاصة عند دمج دوال متعددة.
- عند إجراء القسمة، وخصوصًا عندما يكون القاسم مبنيًا على متغير بيانات، تأكد من مراعاة الحالات التي قد يكون فيها القاسم صفرًا. يمكنك استخدام دالة MAX() لضمان ألا تقل القيمة أبدًا عن 1. على سبيل المثال، تأكد من الحد الأدنى 1 مثل:
{{ 2 / MAX(sessionUser.stats.likes, 1) }}.
تأكد من مراجعة أنواع الوسائط المتوقعة للدوال التي تستخدمها، بالإضافة إلى الترتيب الذي تتوقعه.
على سبيل المثال، {{ UPPERCASE(2) }} سيفشل، لأن UPPERCASE() تتوقع نصًا، ولكن تم إعطاؤها رقمًا.
أمثلة بسيطة للتعبيرات الديناميكية
- حساب بسيط:
{{ 2 + 3 }}يعرض 5. - رسالة مخصصة: مرحبًا
{{sessionUser.name }}يعرض تحية مخصصة. - عرض شرطي:
{{ ideaCollection.stats.ideas.total > 50 ? \"لقد وصلنا إلى هدفنا!\" : \"نحتاج إلى المزيد من الأفكار!\" }}يتكيف بناءً على تفاعل الأفكار.
بدمج هذه المكونات، يمكنك إنشاء تجارب قوية وشخصية لمستخدمي مساحة العمل الخاصة بك.