وسوم القالب في Liquid

تخبر وسومُ القالب Template tags لغةَ Liquid بمكان تعطيل معالجة التعليقات أو الشيفرة التي ليست تابعة للغة Liquid، وكيفية إنشاء علاقات بين ملفات القوالب.

comment

يسمح لك هذا الوسم بوضع شيفرة غير مُصيَّرة ضمن قالب Liquid، إذ لن يُطبَع أيّ نص موجود بين كتل فتح وإغلاق الوسم comment، ولن تُنفَّذ شيفرة Liquid الموجودة ضمنها أيضًا.

{% assign verb = "turned" %}
{% comment %}
{% assign verb = "converted" %}
{% endcomment %}
Anything you put between {% comment %} and {% endcomment %} tags
is {{ verb }} into a comment.

الخرج:

 
 
Anything you put between  tags
is turned into a comment.

raw

يعطّل معالجة الوسوم مؤقتًا، وهذا مفيد لإنشاء محتوى معيّن يستخدم صيغة متضاربة conflicting syntax مثل Mustache أو Handlebars.

{% raw %}
In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
{% endraw %}

الخرج:

In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.

liquid (خاص بالإصدار 5.0.0)

يُستخدَم لإحاطة وسوم متعددة ضمن مجموعة واحدة من المحدّدات، للسماح بكتابة شيفرات Liquid بإيجاز.

{% liquid
case section.blocks.size
when 1
  assign column_size = ''
when 2
  assign column_size = 'one-half'
when 3
  assign column_size = 'one-third'
else
  assign column_size = 'one-quarter'
endcase %}

استخدم الوسم echo لإخراج البيانات، لأنه يجب إغلاق أي كتل وسوم مفتوحة ضمن الوسم liquid بالوسم نفسه.

echo (خاص بالإصدار 5.0.0)

يُستخدَم لإخراج تعبير في شيفرة HTML المصيَّرة، وهذا مماثل لتغليف التعبير بالرموز {{ و }} ولكنه يعمل ضمن وسم liquid ويدعم المرشّحات filters.

{% liquid
for product in collection.products
  echo product.title | capitalize
endfor %}

الخرج:

Hat Shirt Pants

render (خاص بالإصدار 5.0.0)

يُستخدَم لإدخال المحتوى المُصيَّر لقالب آخر ضمن القالب الحالي.

{% render "template-name" %}

لاحظ أنك لست بحاجة إلى كتابة لاحقة الملف ‎.liquid.

لا يمكن للشيفرة الموجود في القالب المُصيَّر الوصول تلقائيًا إلى المتغيرات المُسنَدة باستخدام وسوم المتغير variable tags في القالب الأب، ولا يمكن الوصول إلى المتغيرات المُسنَدة داخل القالب المُصيَّر عن طريق الشيفرة الموجودة في أي قالب آخر.

عاملات render

يمكن تمرير المتغيرات المُسنَدة باستخدام الوسوم ذات النوع المتغير إلى قالب عن طريق إدراجها كعاملات للوسم render.

{% assign my_variable = "apples" %}
{% render "name", my_variable: my_variable, my_other_variable: "oranges" %}

يمكن تمرير كائن واحد أو أكثر إلى قالب.

{% assign featured_product = all_products["product_handle"] %}
{% render "product", product: featured_product %}

with

يمكن تمرير كائن واحد إلى قالب باستخدام العامل with والعامل الاختياري as.

{% assign featured_product = all_products["product_handle"] %}
{% render "product" with featured_product as product %}

سيحتفظ المنتج product في القالب المصيَّر في المثال السابق بالقيمة featured_product من القالب الأب.

for

يمكن تصيير قالب مرة واحدة لكل قيمة لكائن قابل للعدّ باستخدام العامل for والعامل الاختياري as.

{% assign variants = product.variants %}
{% render "product_variant" for variants as variant %}

سيُصيَّر القالب مرة واحدة في المثال السابق لكل product_variant، وسيحتوي المتغير variant على كائن product_variant مختلف لكل تكرار.

يمكن الوصول إلى كائن forloop داخل القالب المُصيَّر عند استخدام العامل for.

include

تنبيه: أُلغِي الوسم include، لذلك استخدم الوسم render بدلًا منه.

يُستخدَم لإدخال المحتوى المُصيَّر لقالبٍ ضمن القالب الحالي.

{% include "template-name" %}

يعمل الوسم include بطريقة مشابهة للوسم render، ولكنه يسمح للشيفرة الموجودة داخل القالب المُصيَّر بالوصول إلى المتغيرات واستبدالها ضمن القالب الأب. أُلغِي هذا الوسم بسبب الطريقة التي يتعامل بها مع المتغيرات التي تقلّل من الأداء وتصعّب قراءة شيفرة Liquid وصيانتها.

لاحظ أنه لا يمكن استخدام الوسم include ضمن القالب عند تصييره باستخدام الوسم render.

مصادر

• صفحة Template في توثيق Liquid الرسمي.