modulo

Syntaxe

Paramètres

Description

Ce filtre permet de calculer le reste de la division entière entre deux nombres.

Remarques

• Outil mathématique fondamental pour les cycles ou motifs : Le filtre modulo est couramment utilisé pour détecter un cycle ou une répétition, par exemple pour afficher un séparateur toutes les 3 itérations ou pour grouper les éléments par ligne. Il constitue un outil logique très utile dans les boucles for.
• Peut servir à déterminer les éléments pairs ou impairs : En utilisant {{ index | modulo: 2 }}, on peut facilement déterminer si un nombre est pair (résultat 0) ou impair (résultat 1). Cette approche est très utilisée dans le rendu conditionnel, comme l'alternance de couleurs de ligne dans un tableau HTML.
• Combinable avec des conditions if pour des affichages dynamiques : Le résultat du modulo peut être utilisé dans une instruction conditionnelle if ou case pour modifier dynamiquement l'affichage ou le comportement d'un bloc en fonction de la position de l'élément dans une boucle.
• Accepte aussi bien des entiers que des nombres décimaux : Même si le modulo est surtout utilisé avec des entiers, il peut aussi s'appliquer à des valeurs décimales. Cela permet des calculs plus souples, par exemple dans des systèmes de notation ou des opérations financières.
• Attention aux divisions par zéro qui provoquent des erreurs : Si le paramètre diviseur est égal à zéro, le filtre échoue ou renvoie un comportement inattendu. Il est donc important de s'assurer que la valeur du diviseur est toujours définie et strictement non nulle.
• Utile pour paginer ou grouper des blocs de contenu : Le filtre peut être utilisé pour afficher les éléments par groupe de N dans une boucle, en testant le reste de la division de l'index de l'élément courant. Cela permet de structurer dynamiquement des lignes, des colonnes ou des sections.
• Peut contribuer à la gestion des classes CSS dynamiques : Grâce au modulo, on peut alterner dynamiquement des classes CSS (exemple : class="ligne-paire" vs class="ligne-impaire"), ce qui améliore l'ergonomie et la lisibilité visuelle des tableaux ou listes dans une page Liquid.
• Idéal pour créer des règles de tri ou de regroupement personnalisées : En combinant modulo avec d'autres filtres comme sort, where, ou group_by, il devient possible de définir des logiques de regroupement conditionnelles non standardisées, par exemple regrouper les éléments selon leur reste de division par 3.