#الاستخدام الأساسي

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

#الاستبدال الأساسي

استخدم العناصر النائبة (placeholders) بالصيغة {d.xxx} لاستبدال البيانات. على سبيل المثال:

• {d.title}: يقرأ حقل title من مجموعة البيانات.
• {d.date}: يقرأ حقل date من مجموعة البيانات.

مثال:

محتوى القالب:

عزيزي العميل،

نشكرك على شرائك منتجنا: {d.productName}.
رقم الطلب: {d.orderId}
تاريخ الطلب: {d.orderDate}

نتمنى لك تجربة ممتعة!

مجموعة البيانات:

{
  "productName": "ساعة ذكية",
  "orderId": "A123456789",
  "orderDate": "2025-01-01"
}

النتيجة المعروضة:

عزيزي العميل،

نشكرك على شرائك منتجنا: ساعة ذكية.
رقم الطلب: A123456789
تاريخ الطلب: 2025-01-01

نتمنى لك تجربة ممتعة!

#الوصول إلى الكائنات الفرعية

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

الصيغة: {d.parent.child}

مثال:

مجموعة البيانات:

{
  "customer": {
    "name": "لي لي",
    "contact": {
      "email": "lilei@example.com",
      "phone": "13800138000"
    }
  }
}

محتوى القالب:

اسم العميل: {d.customer.name}
عنوان البريد الإلكتروني: {d.customer.contact.email}
رقم الهاتف: {d.customer.contact.phone}

النتيجة المعروضة:

اسم العميل: لي لي
عنوان البريد الإلكتروني: lilei@example.com
رقم الهاتف: 13800138000

#الوصول إلى المصفوفات

إذا كانت مجموعة البيانات تحتوي على مصفوفات، يمكنك استخدام الكلمة المفتاحية المحجوزة i للوصول إلى العناصر داخل المصفوفة.

الصيغة: {d.arrayName[i].field}

مثال:

مجموعة البيانات:

{
  "staffs": [
    { "firstname": "James", "lastname": "Anderson" },
    { "firstname": "Emily", "lastname": "Roberts" },
    { "firstname": "Michael", "lastname": "Johnson" }
  ]
}

محتوى القالب:

اسم عائلة الموظف الأول هو {d.staffs[i=0].lastname}، واسمه الأول هو {d.staffs[i=0].firstname}

النتيجة المعروضة:

اسم عائلة الموظف الأول هو Anderson، واسمه الأول هو James