for |
Pour |
|---|---|
| Liquid (Microsoft) | |
Syntaxe
|
{% for variable in collection %} ... instructions à répéter ... {% endfor %} |
Paramètres
| Nom | Description |
|---|---|
| variable | Ce paramètre permet de définir le nom de la variable temporaire qui représentera l'élément courant de la boucle. |
| collection | Ce paramètre permet de spécifier la collection (tableau, liste d'objets, résultats d'une requête,...) à parcourir. |
| limit | Ce paramètre permet de restreindre le nombre maximum d'éléments à parcourir dans la collection. |
| offset | Ce paramètre permet de spécifier un décalage, c'est-à-dire le nombre d'éléments à ignorer au début de la collection. |
| reversed | Ce paramètre permet d'inverser l'ordre de parcours des éléments de la collection. |
Description
Cette balise permet de parcourir une collection d'éléments et d'exécuter un bloc d'instructions pour chaque élément.
Remarques
- Permet le parcours d'une collection structurée : La balise {% for %} permet de parcourir des collections comme des tableaux, des listes d'enregistrements provenant de requêtes FetchXML ou des objets issus d'éléments du portail. Chaque itération donne accès à un élément que l'on peut manipuler individuellement.
- Offre un accès direct aux propriétés de chaque élément : Lors de chaque passage dans la boucle, la variable temporaire définie (exemple : item) permet d'accéder directement aux attributs de l'objet courant. Cela est particulièrement utile pour afficher dynamiquement des champs comme item.fullname ou item.emailaddress1.
- Compatible avec les résultats FetchXML ou des objets JSON : La collection utilisée peut provenir d'un résultat de requête FetchXML ou d'un objet JSON défini manuellement dans Liquid. Cela rend la balise extrêmement flexible pour manipuler diverses sources de données.
- Supporte des paramètres puissants pour affiner l'itération : Grâce aux paramètres limit et offset, on peut facilement paginer ou tronquer une collection, par exemple en affichant seulement les 5 premiers résultats ou en sautant les 3 premiers. Cela permet un contrôle précis sur le contenu affiché.
- L'option reversed permet d'inverser le sens de la boucle : Le paramètre reversed modifie l'ordre d'itération pour commencer par la fin de la collection. Cela peut être utile pour afficher les éléments les plus récents en premier, par exemple une liste de commentaires ou de publications.
- Fournit des variables de boucle intégrées : À l'intérieur de la boucle, des variables comme forloop.index, forloop.first ou permettent de détecter la position courante dans la collection. On peut ainsi appliquer un style différent au premier ou dernier élément, ou numéroter dynamiquement les lignes.
- Peut être combinée avec des structures conditionnelles : Il est courant de combiner for avec if ou case pour filtrer ou ajuster dynamiquement l'affichage selon certaines conditions. Cela permet d'intégrer une logique métier directement dans l'interface de manière simple et lisible.
- S'accompagne toujours d'une balise fermante endfor : Comme toutes les balises de bloc de Liquid, la balise for doit être correctement fermée avec {% endfor %}. En cas d'omission, la page peut ne pas s'afficher correctement ou provoquer une erreur de rendu Liquid.
Dernière mise à jour : Mercredi, le 23 Juillet 2025