Section courante

A propos

Section administrative du site

Itération de balises

Les balises d'itération sont utilisées pour exécuter/rendre un bloc de code de manière répétée.

for

Exécute un bloc de code de manière répétée. Cette méthode est généralement utilisée pour parcourir les éléments d'un tableau ou d'un dictionnaire.

L'objet forloop est disponible dans le bloc de balises for.

  1. {% for child_page in page.children %}
  2.  
  3. <a href={{ child_page.url }}>{{ child_page.title }}</a>
  4.  
  5. {% endfor %}

Sortie :

<a href=/parent/child1/>Child 1</a>

<a href=/parent/child2/>Child 2</a>

<a href=/parent/child3/>Child 3</a>

Paramètres

Ces paramètres peuvent être utilisés seuls ou combinés.

Attribut Description
limit Quitte la boucle après un nombre donné d'éléments.

  1. {% for child_page in page.children limit:2 %}
  2.  
  3. <a href={{ child_page.url }}>{{ child_page.title }}</a>
  4.  
  5. {% endfor %}

Sortie :

<a href=/parent/child1/>Child 1</a>

<a href=/parent/child2/>Child 2</a>
Attribut Description
offset Démarre la boucle à l'index donné.

  1. {% for child_page in page.children offset:1 %}
  2.  
  3. <a href={{ child_page.url }}>{{ child_page.title }}</a>
  4.  
  5. {% endfor %}

Sortie :

<a href=/parent/child2/>Child 2</a> <a href=/parent/child3/>Child 3</a>
Attribut Description
range Définit un intervalle de nombres à parcourir.

  1. {% assign n = 4 %}
  2.  
  3. {% for i in (2..n) %}
  4.  
  5. {{ i }}
  6.  
  7. {% endfor %}
  8.  
  9. {% for i in (10..14) %}
  10.  
  11. {{ i }}
  12.  
  13. {% endfor }}

Sortie :

2 3 4

10 11 12 14
Attribut Description
reversed Parcourt la boucle dans l'ordre inverse, en commençant par le dernier élément.

Code :

  1. {% for child_page in page.children reversed %}
  2.  
  3. <a href={{ child_page.url }}>{{ child_page.title }}</a>
  4.  
  5. {% endfor %}

Sortie :

<a href=/parent/child3/>Child 3</a>

<a href=/parent/child2/>Child 2</a>

<a href=/parent/child1/>Child 1</a>

cycle

Parcourt un groupe de chaînes et les renvoie dans l'ordre de leur passage en paramètres. À chaque appel de cycle, la chaîne suivante passée en paramètre est renvoyée.

  1. {% for item in items %}
  2.  
  3. <div class={% cycle 'red', 'green', 'blue' %}> {{ item }} </div>
  4.  
  5. {% end %}

Sortie :

<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

Génère un tableau HTML. Doit être entouré d'une balise HTML ouvrante <table> et fermante </table>.

La boucle tablerowloop est disponible dans le bloc de balises tablerow.

Code :

  1. <table>
  2.  
  3. {% tablerow child_page in page.children %}
  4.  
  5. {{ child_page.title }}
  6.  
  7. {% endtablerow %}
  8.  
  9. </table>

Sortie :

  1. <table>
  2.  
  3. <tr class=row1>
  4.  
  5. <td class=col1>
  6.  
  7. Child Page 1
  8.  
  9. </td>
  10.  
  11. <td class=col2>
  12.  
  13. Child Page 2
  14.  
  15. </td>
  16.  
  17. <td class=col3>
  18.  
  19. Child Page 3
  20.  
  21. </td>
  22.  
  23. <td class=col4>
  24.  
  25. Child Page 4
  26.  
  27. </td>
  28.  
  29. </tr>
  30.  
  31. </table>

Paramètres

Ces paramètres de tablerow peuvent être utilisés seuls ou combinés.

Sortie :

  1. <table>
  2.  
  3. <tr class=row1>
  4.  
  5. <td class=col1>
  6.  
  7. Child Page 1
  8.  
  9. </td>
  10.  
  11. <td class=col2>
  12.  
  13. Child Page 2
  14.  
  15. </td>
  16.  
  17. </tr>
  18.  
  19. <tr class=row2>
  20.  
  21. <td class=col3>
  22.  
  23. Child Page 3
  24.  
  25. </td>
  26.  
  27. <td class=col4>
  28.  
  29. Child Page 4
  30.  
  31. </td>
  32.  
  33. </tr>
  34.  
  35. </table>

Code :

  1. <table>
  2.  
  3. {% tablerow child_page in page.children cols:2 %}
  4.  
  5. {{ child_page.title }}
  6.  
  7. {% endtablerow %}
  8.  
  9. </table>

Indique le nombre de lignes que la table générée doit contenir :

cols

limit

Quitte la boucle après un nombre donné d'éléments.

Code :

  1. <table>
  2.  
  3. {% tablerow child_page in page.children limit:2 %}
  4.  
  5. {{ child_page.title }}
  6.  
  7. {% endtablerow %}
  8.  
  9. </table>

Sortie :

  1. <table>
  2.  
  3. <tr class=row1>
  4.  
  5. <td class=col1>
  6.  
  7. Child Page 1
  8.  
  9. </td>
  10.  
  11. <td class=col2>
  12.  
  13. Child Page 2
  14.  
  15. </td>
  16.  
  17. </tr>
  18.  
  19. </table>

offset

Démarre la boucle à l'index donné.

Code

  1. <table>
  2.  
  3. {% tablerow child_page in page.children offset:2 %}
  4.  
  5. {{ child_page.title }}
  6.  
  7. {% endtablerow %}
  8.  
  9. </table>

Sortie :

  1. <table>
  2.  
  3. <tr class=row1>
  4.  
  5. <td class=col1>
  6.  
  7. Child Page 3
  8.  
  9. </td>
  10.  
  11. <td class=col2>
  12.  
  13. Child Page 4
  14.  
  15. </td>
  16.  
  17. </tr>
  18.  
  19. </table>

range

Définit une plage de nombres à parcourir.

Code :

  1. <table>
  2.  
  3. {% tablerow i in (1..3) %}
  4.  
  5. {{ i }}
  6.  
  7. {% endtablerow %}
  8.  
  9. </table>

Dernière mise à jour : Vendredi, le 18 juillet 2025