Etiquetas de iterações
As etiquetas de iteração são utilizadas para executar/compor um bloco de código repetidamente.
para
Executa um bloco de código repetidamente. É o mais utilizado para iterar os itens numa matriz ou dicionário.
No bloco de etiquetas, o objeto forloop está disponível.
Código
{% for child_page in page.children %}
<a href={{ child_page.url }}>{{ child_page.title }}</a>
{% endfor %}
Saída
<a href=/parent/child1/>Child 1</a>
<a href=/parent/child2/>Child 2</a>
<a href=/parent/child3/>Child 3</a>
Parâmetros
Estes parâmetros de for podem ser utilizados isolados ou numa combinação.
limit
Sai do ciclo ao fim de um determinado número de itens.
Código
{% for child_page in page.children limit:2 %}
<a href={{ child_page.url }}>{{ child_page.title }}</a>
{% endfor %}
Saída
<a href=/parent/child1/>Child 1</a>
<a href=/parent/child2/>Child 2</a>
offset
Inicia o ciclo em determinado índice.
Código
{% for child_page in page.children offset:1 %}
<a href={{ child_page.url }}>{{ child_page.title }}</a>
{% endfor %}
Saída
<a href=/parent/child2/>Child 2</a>
<a href=/parent/child3/>Child 3</a>
range
Define um intervalo de números para efetuar o ciclo.
Código
{% assign n = 4 %}
{% for i in (2..n) %}
{{ i }}
{% endfor %}
{% for i in (10..14) %}
{{ i }}
{% endfor }}
Saída
2 3 4
10 11 12 14
reversed
Itera através do ciclo pela ordem inversa, a começar pelo último item.
Código
{% for child_page in page.children reversed %}
<a href={{ child_page.url }}>{{ child_page.title }}</a>
{% endfor %}
Saída
<a href=/parent/child3/>Child 3</a>
<a href=/parent/child2/>Child 2</a>
<a href=/parent/child1/>Child 1</a>
cycle
Efetua o ciclo ao longo de um grupo de cadeias e gera-as pela ordem em que foram transmitidos como parâmetros. De cada vez que o ciclo é chamado, é gerada a cadeia seguinte a ser transmitida como um parâmetro.
Código
{% for item in items %}
<div class={% cycle 'red', 'green', 'blue' %}> {{ item }} </div>
{% end %}
Saída
<div class=red> Item one </div>
<div class=green> Item two </div>
<div class=blue> Item three </div>
<div class=red> Item four </div>
<div class=green> Item five</div>
tablerow
Gera uma tabela HTML. Tem de ser moldada entre as etiquetas HTML de abertura e fecho <table> e </table>.
No bloco de etiquetas tablerow, o tablerowloop está disponível.
Código
<table>
{% tablerow child_page in page.children %}
{{ child_page.title }}
{% endtablerow %}
</table>
Saída
<table>
<tr class=row1>
<td class=col1>
Child Page 1
</td>
<td class=col2>
Child Page 2
</td>
<td class=col3>
Child Page 3
</td>
<td class=col4>
Child Page 4
</td>
</tr>
</table>
Parâmetros
Estes parâmetros de tablerow podem ser utilizados isolados ou numa combinação.
Saída
<table>
<tr class=row1>
<td class=col1>
Child Page 1
</td>
<td class=col2>
Child Page 2
</td>
</tr>
<tr class=row2>
<td class=col3>
Child Page 3
</td>
<td class=col4>
Child Page 4
</td>
</tr>
</table>
Código
<table>
{% tablerow child_page in page.children cols:2 %}
{{ child_page.title }}
{% endtablerow %}
</table>
Dita o número de linhas que a tabela gerada deve ter.
cols
limit
Sai do ciclo ao fim de um determinado número de itens.
Código
<table>
{% tablerow child_page in page.children limit:2 %}
{{ child_page.title }}
{% endtablerow %}
</table>
Saída
<table>
<tr class=row1>
<td class=col1>
Child Page 1
</td>
<td class=col2>
Child Page 2
</td>
</tr>
</table>
offset
Inicia o ciclo em determinado índice.
Código
<table>
{% tablerow child_page in page.children offset:2 %}
{{ child_page.title }}
{% endtablerow %}
</table>
Saída
<table>
<tr class=row1>
<td class=col1>
Child Page 3
</td>
<td class=col2>
Child Page 4
</td>
</tr>
</table>
range
Define um intervalo de números para efetuar o ciclo.
Código
<table>
{% tablerow i in (1..3) %}
{{ i }}
{% endtablerow %}
</table>