عرض مصدر Liquid/template

<noinclude>{{DISPLAYTITLE: وسوم القالب في Liquid}}</noinclude>
تخبر وسومُ القالب Template tags لغةَ Liquid بمكان تعطيل معالجة التعليقات أو الشيفرة التي ليست تابعة للغة Liquid، وكيفية إنشاء علاقات بين ملفات القوالب.

== <code>comment</code> ==
يسمح لك هذا الوسم بوضع شيفرة غير مُصيَّرة ضمن قالب Liquid، إذ لن يُطبَع أيّ نص موجود بين كتل فتح وإغلاق الوسم <code>comment</code>، ولن تُنفَّذ شيفرة Liquid الموجودة ضمنها أيضًا.<syntaxhighlight lang="liquid">
{% assign verb = "turned" %}
{% comment %}
{% assign verb = "converted" %}
{% endcomment %}
Anything you put between {% comment %} and {% endcomment %} tags
is {{ verb }} into a comment.
</syntaxhighlight>الخرج:<syntaxhighlight lang="liquid">
 
 
Anything you put between  tags
is turned into a comment.
</syntaxhighlight>
== <code>raw</code> ==
يعطّل معالجة الوسوم مؤقتًا، وهذا مفيد لإنشاء محتوى معيّن يستخدم صيغة متضاربة conflicting syntax مثل [https://mustache.github.io/ Mustache] أو [https://handlebarsjs.com/ Handlebars].<syntaxhighlight lang="liquid">
{% raw %}
In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
{% endraw %}
</syntaxhighlight>الخرج:<syntaxhighlight lang="liquid">

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

</syntaxhighlight>
== <code>liquid</code> (خاص بالإصدار 5.0.0) ==
يُستخدَم لإحاطة وسوم متعددة ضمن مجموعة واحدة من المحدّدات، للسماح بكتابة شيفرات Liquid بإيجاز.<syntaxhighlight lang="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 %}
</syntaxhighlight>استخدم الوسم <code>echo</code> لإخراج البيانات، لأنه يجب إغلاق أي كتل وسوم مفتوحة ضمن الوسم <code>liquid</code> بالوسم نفسه.

== <code>echo</code> (خاص بالإصدار 5.0.0) ==
يُستخدَم لإخراج تعبير في شيفرة HTML المصيَّرة، وهذا مماثل لتغليف التعبير بالرموز <code><nowiki>{{</nowiki></code> و <code><nowiki>}}</nowiki></code> ولكنه يعمل ضمن وسم <code>liquid</code> ويدعم [[Liquid/filters|المرشّحات filters]].<syntaxhighlight lang="liquid">
{% liquid
for product in collection.products
  echo product.title | capitalize
endfor %}
</syntaxhighlight>الخرج:<syntaxhighlight lang="liquid">
Hat Shirt Pants
</syntaxhighlight>
== <code>render</code> (خاص بالإصدار 5.0.0) ==
يُستخدَم لإدخال المحتوى المُصيَّر لقالب آخر ضمن القالب الحالي.<syntaxhighlight lang="liquid">
{% render "template-name" %}
</syntaxhighlight>لاحظ أنك لست بحاجة إلى كتابة لاحقة الملف ‎<code>.liquid</code>.

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

== عاملات <code>render</code> ==

يمكن تمرير المتغيرات المُسنَدة باستخدام الوسوم ذات النوع المتغير إلى قالب عن طريق إدراجها كعاملات للوسم <code>render</code>.<syntaxhighlight lang="liquid">
{% assign my_variable = "apples" %}
{% render "name", my_variable: my_variable, my_other_variable: "oranges" %}
</syntaxhighlight>يمكن تمرير كائن واحد أو أكثر إلى قالب.<syntaxhighlight lang="liquid">
{% assign featured_product = all_products["product_handle"] %}
{% render "product", product: featured_product %}
</syntaxhighlight>

=== <code>with</code> ===

يمكن تمرير كائن واحد إلى قالب باستخدام العامل <code>with</code> والعامل الاختياري <code>as</code>.<syntaxhighlight lang="liquid">
{% assign featured_product = all_products["product_handle"] %}
{% render "product" with featured_product as product %}
</syntaxhighlight>سيحتفظ المنتج <code>product</code> في القالب المصيَّر في المثال السابق بالقيمة <code>featured_product</code> من القالب الأب.

=== <code>for</code> ===

يمكن تصيير قالب مرة واحدة لكل قيمة لكائن قابل للعدّ باستخدام العامل <code>for</code> والعامل الاختياري <code>as</code>.<syntaxhighlight lang="liquid">
{% assign variants = product.variants %}
{% render "product_variant" for variants as variant %}
</syntaxhighlight>سيُصيَّر القالب مرة واحدة في المثال السابق لكل <code>product_variant</code>، وسيحتوي المتغير <code>variant</code> على كائن <code>product_variant</code> مختلف لكل تكرار.

يمكن الوصول إلى كائن <code>[https://shopify.dev/api/liquid/objects/for-loops forloop]</code> داخل القالب المُصيَّر عند استخدام العامل <code>for</code>.

== <code>include</code> ==
<blockquote>'''تنبيه''': أُلغِي الوسم <code>include</code>، لذلك استخدم الوسم <code>render</code> بدلًا منه.</blockquote>يُستخدَم لإدخال المحتوى المُصيَّر لقالبٍ ضمن القالب الحالي.<syntaxhighlight lang="liquid">
{% include "template-name" %}
</syntaxhighlight>يعمل الوسم <code>include</code> بطريقة مشابهة للوسم <code>render</code>، ولكنه يسمح للشيفرة الموجودة داخل القالب المُصيَّر بالوصول إلى المتغيرات واستبدالها ضمن القالب الأب. أُلغِي هذا الوسم بسبب الطريقة التي يتعامل بها مع المتغيرات التي تقلّل من الأداء وتصعّب قراءة شيفرة Liquid وصيانتها.

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

== مصادر ==

* [https://shopify.github.io/liquid/tags/template/ صفحة Template في توثيق Liquid الرسمي.]
[[تصنيف:Liquid]]