batch |
Traitement par lot |
|---|---|
| Liquid (Microsoft) | |
Syntaxe
|
{{ collection | batch: taille }} {% for sous_liste in collection | batch: taille %} {% for item in sous_liste %} {{ item }} {% endfor %} {% endfor %} |
Paramètres
| Nom | Description |
|---|---|
| collection | Ce paramètre permet de désigner la collection initiale (liste d'éléments) à diviser en groupes de taille fixe. |
| sous_liste | Ce paramètre permet de représenter un sous-ensemble (sous-tableau) généré automatiquement à partir de la collection. Chaque sous-liste contient jusqu'à taille éléments. |
| item | Ce paramètre permet de représenter un élément individuel au sein d'une sous_liste. Il est utilisé pour accéder ou afficher les données de chaque élément. |
Description
Ce filtre permet de segmenter une collection en sous-tableaux de taille spécifiée.
Remarques
- Permet de segmenter les données en groupes fixes pour un affichage structuré : Le filtre batch est idéal pour diviser une collection de données en blocs de taille égale. Cela s'avère particulièrement utile pour construire des grilles, des tableaux, ou toute mise en page qui nécessite un découpage régulier des données, comme des galeries d'images ou des cartes produit.
- Simplifie la gestion du contenu en colonnes ou en rangées : Grâce à ce filtre, il devient facile de créer des lignes contenant un nombre fixe d'éléments. Par exemple, en spécifiant une taille de 3, chaque sous-liste pourra alimenter une ligne de 3 colonnes dans un tableau HTML, ce qui réduit la complexité de la mise en forme dans le code.
- Compatible avec les boucles imbriquées pour un contrôle précis du rendu : L'utilisation typique du filtre batch nécessite une double boucle : une première pour parcourir les sous-listes, une seconde pour afficher les éléments individuels. Cette structure imbriquée permet de personnaliser précisément l'agencement de l'interface utilisateur.
- Permet un rendu adaptatif même si la taille de la collection n'est pas un multiple exact : Si la taille de la collection ne peut pas être divisée exactement par la taille de lot spécifiée, la dernière sous-liste contiendra simplement moins d'éléments. Cela permet une gestion souple sans erreur ni omission des données restantes.
- Facilite la mise en page responsive dans les portails web : En combinant batch avec des classes CSS (comme Bootstrap ou Tailwind), on peut facilement adapter le nombre d'éléments par ligne selon la taille de l'écran. Cela rend ce filtre essentiel pour les interfaces adaptatives.
- Optimise la lisibilité du code Liquid dans les pages complexes : Plutôt que de calculer manuellement les index pour découper une collection, le filtre batch fournit un mécanisme simple et lisible pour structurer les données. Cela diminue les risques d'erreurs logiques et améliore la maintenance du code.
- Peut être combiné avec d'autres filtres pour enrichir le contenu affiché : Avant ou après avoir utilisé batch, on peut appliquer des filtres comme sort, where ou limit pour affiner les données affichées dans chaque sous-liste. Cela permet de créer des interfaces dynamiques à base de collections filtrées ou ordonnées.
- Utile pour des interfaces utilisateur guidées ou paginées visuellement : Dans certains cas, on peut se servir de batch pour simuler une pagination visuelle ou un affichage étape par étape (par exemple : étapes d'un formulaire, listes d'options réparties). Même si ce n'est pas une vraie pagination côté serveur, cela améliore l'expérience utilisateur dans des affichages volumineux.
Dernière mise à jour : Jeudi, le 24 Juillet 2025