Iteration
Iteration
Iteration tags run blocks of code repeatedly.
for
Repeatedly executes a block of code. For a full list of attributes available within a for loop, see forloop (object).
Input
{% for product in collection.products %} {{ product.title }} {% endfor %}
Output
hat shirt pants
break
Causes the loop to stop iterating when it encounters the break tag.
Input
{% for i in (1..5) %} {% if i == 4 %} {% break %} {% else %} {{ i }} {% endif %} {% endfor %}
Output
1 2 3
continue
Causes the loop to skip the current iteration when it encounters the continue tag.
Input
{% for i in (1..5) %} {% if i == 4 %} {% continue %} {% else %} {{ i }} {% endif %} {% endfor %}
Output
1 2 3 5
for (parameters)
limit
Limits the loop to the specified number of iterations.
Input
<!-- if array = [1,2,3,4,5,6] --> {% for item in array limit:2 %} {{ item }} {% endfor %}
Output
1 2
offset
Begins the loop at the specified index.
Input
<!-- if array = [1,2,3,4,5,6] --> {% for item in array offset:2 %} {{ item }} {% endfor %}
Output
3 4 5 6
range
Defines a range of numbers to loop through. The range can be defined by both literal and variable numbers.
Input
{% for i in (3..5) %} {{ i }} {% endfor %} {% assign num = 4 %} {% for i in (1..num) %} {{ i }} {% endfor %}
Output
3 4 5 1 2 3 4
reversed
Reverses the order of the loop. Note that the flag’s spelling is different to the filter reverse.
Input
<!-- if array = [1,2,3,4,5,6] --> {% for item in array reversed %} {{ item }} {% endfor %}
Output
6 5 4 3 2 1
cycle
Loops through a group of strings and outputs them in the order that they were passed as parameters. Each time cycle is called, the next string that was passed as a parameter is output.
cycle must be used within a for loop block.
Input
{% cycle 'one', 'two', 'three' %} {% cycle 'one', 'two', 'three' %} {% cycle 'one', 'two', 'three' %} {% cycle 'one', 'two', 'three' %}
Output
one two three one
Uses for cycle include:
- applying odd/even classes to rows in a table
- applying a unique class to the last product thumbnail in a row
cycle (parameters)
cycle accepts a parameter called cycle group in cases where you need multiple cycle blocks in one template. If no name is supplied for the cycle group, then it is assumed that multiple calls with the same parameters are one group.
tablerow
Generates an HTML table. Must be wrapped in opening <table> and closing </table> HTML tags.
Input
<table> {% tablerow product in collection.products %} {{ product.title }} {% endtablerow %} </table>
Output
<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>
tablerow (parameters)
cols
Defines how many columns the tables should have.
Input
{% tablerow product in collection.products cols:2 %} {{ product.title }} {% endtablerow %}
Output
<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>
limit
Exits the tablerow after a specific index.
{% tablerow product in collection.products cols:2 limit:3 %} {{ product.title }} {% endtablerow %}
offset
Starts the tablerow after a specific index.
{% tablerow product in collection.products cols:2 offset:3 %} {{ product.title }} {% endtablerow %}
range
Defines a range of numbers to loop through. The range can be defined by both literal and variable numbers.
<!--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>
© 2005, 2006 Tobias Luetke
Licensed under the MIT License.
https://shopify.github.io/liquid/tags/iteration/