وسوم Liquid

يشغّل محرّك دكان LiquidJS بوسومه القياسية وخيارات مشدّدة. هذه الصفحة تجمع ما تحتاج معرفته عن الوسوم دون تكرار توثيق Liquid العام.

الخيارات المشدّدة#

layout وblock#

{% layout 'layout/theme.liquid' %}
{% block content %}
  <h1>{{ category.name }}</h1>
{% endblock %}

• يجب أن يكون {% layout %} أول وسم في القالب، ومساره كاملاً.
• يعلن الهيكل كتلاً بـ {% block NAME %}…{% endblock %} ومحتواها الافتراضي داخلها؛ يملؤها القالب بالاسم نفسه.
• يمكن للهيكل أن يعلن أكثر من كتلة (head_extra، content)؛ ما لم يملأه القالب يبقى على افتراضي الهيكل.
• لا يوجد متغير لمحتوى القالب داخل الهيكل؛ {% block %} هو الطريق الوحيد.

include#

{% include 'snippets/product-card.liquid' %}
{% include 'snippets/pager.liquid', pager_base: category.url %}
{% assign icon = 'cart' %}{% include 'snippets/icons.liquid' %}

• المسار كامل من جذر الحزمة مع الامتداد؛ الملف الغائب يفشل التصيير برسالة template not found.
• يشارك المقطع نطاق المتغيرات مع من ضمّنه (نمط include لا render)، ويقبل معاملات مسمّاة تُصبح متغيرات.
• تضمين assets/theme.css داخل <style> هو الطريقة المعتمدة لشحن CSS.

وسوم التحكم والحلقات#

if/elsif/else/unless، case/when، for مع forloop وbreak/continue وlimit/offset/reversed، tablerow، assign، capture، comment، liquid، echo: كلها متاحة كما في LiquidJS.

{% for product in products limit: 8 %}
  {% if forloop.first %}<ul>{% endif %}
  <li>{{ product.name }}</li>
  {% if forloop.last %}</ul>{% endif %}
{% endfor %}

increment وdecrement وcycle#

raw (الوسم)#

{% raw %}…{% endraw %} وسم قياسي لإخراج نص يحوي أقواس Liquid حرفياً؛ مسموح، لأنه يُهرَّب كأي نص. لا تخلط بينه وبين المرشّح | raw المعطَّل.

ما يُرفض عند الدفع#

أي <script> غير JSON-LD، ومعالجات الأحداث السطرية، وjavascript:، وdata:text/html، و<iframe>، والمرشّح | raw، وعلامات غلاف الأقسام. القائمة بنصوصها في فحص الثيم.