عرض مصدر Liquid/iteration

== الوسوم Tags ذات النوع التكراري Iteration ==
تشغّل الوسوم التكرارية كتلًا من الشيفرة تكراريًا.

=== for ===
ينفّذ كتلة من الشيفرة تكراريًا. اطّلع على قائمة كاملة بالسمات attributes المتاحة داخل حلقة <code>for</code> من خلال [https://shopify.dev/api/liquid/objects/for-loops forloop (object)].
{| class="wikitable"
|+
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% for product in collection.products %}
  {{ product.title }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
hat shirt pants
</syntaxhighlight>
|}
==== else ====
يحدّد حالة احتياطية لحلقة <code>for</code> والتي ستُشغَّل إذا كان طول الحلقة صفرًا.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% for product in collection.products %}
  {{ product.title }}
{% else %}
  The collection is empty.
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
The collection is empty.
</syntaxhighlight>
|}
==== break ====
يسبّب توقف تكرار الحلقة عندما تواجه وسم <code>break</code>.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% for i in (1..5) %}
  {% if i == 4 %}
    {% break %}
  {% else %}
    {{ i }}
  {% endif %}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
1 2 3
</syntaxhighlight>
|}
==== continue ====
يسبّب أن تتخطى الحلقة التكرار الحالي عندما تواجه وسم <code>continue</code>.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% for i in (1..5) %}
  {% if i == 4 %}
    {% continue %}
  {% else %}
    {{ i }}
  {% endif %}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
1 2 3   5
</syntaxhighlight>
|}
=== عاملات حلقة for ===

==== limit ====
يحدّد الحلقة بعدد محدّد من التكرارات.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
<!-- if array = [1,2,3,4,5,6] -->
{% for item in array limit:2 %}
  {{ item }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
1 2
</syntaxhighlight>
|}
==== offset ====
يبدأ الحلقة عند دليل محدَّد.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
<!-- if array = [1,2,3,4,5,6] -->
{% for item in array offset:2 %}
  {{ item }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
3 4 5 6
</syntaxhighlight>
|}
مرّر الكلمة الخاصة <code>continue</code>، لبدء حلقة من حيث توقفت الحلقة الأخيرة باستخدام نفس المكرّر.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
<!-- if array = [1,2,3,4,5,6] -->
{% for item in array limit: 3 %}
  {{ item }}
{% endfor %}
{% for item in array limit: 3 offset: continue %}
  {{ item }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
1 2 3
4 5 6
</syntaxhighlight>
|}
==== range ====
يحدّد مجالًا من الأعداد لتكرارها. يمكن تحديد المجال من خلال كلِّ من الأعداد الحرفية literal والمتغيرة variable، ويمكن سحبها من المتغير.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% for i in (3..5) %}
  {{ i }}
{% endfor %}

{% assign num = 4 %}
{% assign range = (1..num) %}
{% for i in range %}
  {{ i }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
3 4 5
1 2 3 4
</syntaxhighlight>
|}
==== reversed ====
يعكس ترتيب الحلقة. انتبه إلى أن هذا العامل يختلف عن المرشّح <code>reverse</code>.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
<!-- if array = [1,2,3,4,5,6] -->
{% for item in array reversed %}
  {{ item }}
{% endfor %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
6 5 4 3 2 1
</syntaxhighlight>
|}
=== cycle ===
يدور ضمن حلقات عبر مجموعة من السلاسل النصية ويطبع هذه السلاسل النصية بالترتيب الذي مُرِّرت به كوسطاء، إذ يُطبَع وسيط السلسلة النصية التالية في كل مرة يُستدعَى بها <code>cycle</code>.

يجب استخدام <code>cycle</code> ضمن كتلة حلقة for.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% cycle "one", "two", "three" %}
{% cycle "one", "two", "three" %}
{% cycle "one", "two", "three" %}
{% cycle "one", "two", "three" %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
one
two
three
one
</syntaxhighlight>
|}
تشمل استخدامات <code>cycle</code> ما يلي:

* تطبيق أصناف classes فردية أو زوجية على صفوف في جدول.
* تطبيق صنف فريد على صور المنتج المُصغَّرة الأخيرة في صف.

=== عاملات cycle ===
يقبل <code>cycle</code> عامل "مجموعة cycle" في الحالات التي تحتاج فيها إلى كتل <code>cycle</code> متعددة في قالب واحد. إذا لم يتوفر أي اسم لمجموعة cycle، فيُفترَض أن تمثّل الاستدعاءات المتعددة التي لها العاملات نفسها مجموعةً واحدة.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% cycle "first": "one", "two", "three" %}
{% cycle "second": "one", "two", "three" %}
{% cycle "second": "one", "two", "three" %}
{% cycle "first": "one", "two", "three" %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
one
one
two
two
</syntaxhighlight>
|}
=== tablerow ===
يولّد هذا الوسم جدول HTML، إذ يجب أن يُغلَّف بوسم فتح <code><nowiki><table></nowiki></code> ووسم إغلاق <code><‎/table></code> خاصين بلغة HTML. اطّلع على قائمة كاملة بالسمات attributes المتاحة داخل حلقة <code>tablerow</code> من خلال  [https://shopify.dev/api/liquid/objects/tablerow tablerow (object)].
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
<table>
{% tablerow product in collection.products %}
  {{ product.title }}
{% endtablerow %}
</table>
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
<table>
  <tr class="row1">
    <td class="col1">
      Cool Shirt
    </td>
    <td class="col2">
      Alien Poster
    </td>
    <td class="col3">
      Batman Poster
    </td>
    <td class="col4">
      Bullseye Shirt
    </td>
    <td class="col5">
      Another Classic Vinyl
    </td>
    <td class="col6">
      Awesome Jeans
    </td>
  </tr>
</table>
</syntaxhighlight>
|}
=== عاملات حلقة tablerow ===

==== cols ====
يحدّد عدد الأعمدة التي يجب أن تحتوي عليها الجداول.
{| class="wikitable"
!الدخل
!الخرج
|-
|<syntaxhighlight lang="liquid">
{% tablerow product in collection.products cols:2 %}
  {{ product.title }}
{% endtablerow %}
</syntaxhighlight>
|<syntaxhighlight lang="liquid">
<table>
  <tr class="row1">
    <td class="col1">
      Cool Shirt
    </td>
    <td class="col2">
      Alien Poster
    </td>
  </tr>
  <tr class="row2">
    <td class="col1">
      Batman Poster
    </td>
    <td class="col2">
      Bullseye Shirt
    </td>
  </tr>
  <tr class="row3">
    <td class="col1">
      Another Classic Vinyl
    </td>
    <td class="col2">
      Awesome Jeans
    </td>
  </tr>
</table>
</syntaxhighlight>
|}
==== limit ====
يخرج من حلقة <code>tablerow</code> بعد دليل معين.<syntaxhighlight lang="liquid">
{% tablerow product in collection.products cols:2 limit:3 %}
  {{ product.title }}
{% endtablerow %}
</syntaxhighlight>

==== offset ====
يبدأ بحلقة <code>tablerow</code> بعد دليل معين.<syntaxhighlight lang="liquid">
{% tablerow product in collection.products cols:2 offset:3 %}
  {{ product.title }}
{% endtablerow %}
</syntaxhighlight>

==== range ====
يحدّد مجالًا من الأعداد لتكرارها. يمكن تحديد المجال من خلال كلِّ من الأعداد الحرفية والمتغيرة.<syntaxhighlight lang="liquid">
<!--variable number example-->

{% assign num = 4 %}
<table>
{% tablerow i in (1..num) %}
  {{ i }}
{% endtablerow %}
</table>

<!--literal number example-->

<table>
{% tablerow i in (3..5) %}
  {{ i }}
{% endtablerow %}
</table>
</syntaxhighlight>

== مصادر ==

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