ملء القوالب
املأ قالب Mustache ببيانات من JSON أو CSV لاستخدامه في دمج المراسلات أو ملفات الإعداد أو النصوص المجمّعة. اكتب عناصر نائبة مثل {{name}}، وأقسامًا مثل {{#items}}...{{/items}} وشروطًا، ثم الصق البيانات. ينتج عن كل صف في CSV أو كل عنصر في مصفوفة JSON نسخة واحدة معبأة من القالب.
الأسئلة الشائعة
ما صياغة القوالب المدعومة؟
Mustache: {{name}} لقيمة، و{{user.email}} للقيم المتداخلة، و{{#list}}...{{/list}} لتكرار قائمة أو عرض كتلة عند ضبط قيمة، و{{^list}}...{{/list}} للحالة العكسية، و{{.}} للعنصر الحالي، و{{! comment}} للتعليقات.
كيف يعمل دمج المراسلات مع CSV؟
يحتوي الصف الأول من CSV على أسماء الأعمدة، ويملأ كل صف لاحق القالب مرة واحدة. يُستخدم عمود اسمه first name بالشكل {{first name}}. تُجمع النسخ باستخدام الفاصل الذي تختاره، مثل سطر فارغ أو قاعدة ---.
ما أنواع JSON التي يمكنني استخدامها؟
يملأ الكائن القالب مرة واحدة. أما مصفوفة من الكائنات فتملؤه مرة لكل عنصر، مثل صفوف CSV. لعرض قائمة داخل قالب واحد، ضعها في كائن مثل {"items": [...]} واستخدم قسمًا.
متى يُخفى القسم؟
يُخفى قسم {{#name}} عندما تكون القيمة مفقودة أو false أو null أو 0 أو سلسلة نصية فارغة أو قائمة فارغة. ويُعرض قسم {{^name}} المعكوس في هذه الحالات تحديدًا.
هل تُجرى عملية الهروب على HTML؟
تُجرى فقط إذا فعّلت الهروب في HTML. عندها يهرب {{name}} محارف مثل < و&، بينما يُدرج {{{name}}} و{{& name}} القيمة كما هي. وبدون ذلك تُدرج جميع القيم كما هي، وهو مناسب للنص العادي والبريد الإلكتروني.
هل تُدعم الأجزاء الجزئية والدوال اللامبدا؟
لا. لا تنتج الأجزاء الجزئية ({{> name}}) أي مخرجات، ولا يمكن استخدام الدوال اللامبدا لأن البيانات هي JSON أو CSV. وتعمل بقية صياغة Mustache، بما فيها تغيير المحددات باستخدام {{=<% %>=}}.