وسوم القالب في 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.