divided_by

Syntaxe

Paramètres

Description

Ce filtre permet de diviser une valeur par un diviseur.

Remarques

• Permet d'effectuer des calculs simples directement dans les modèles Liquid : Le filtre divided_by est utile pour intégrer des opérations mathématiques de base sans recourir à du code serveur ou JavaScript. Cela permet de préparer ou de transformer dynamiquement des données dans l'interface, par exemple pour des rapports ou des prix calculés.
• Utile dans les cas de mise en page conditionnelle ou de regroupement : Ce filtre est idéal pour diviser un total en portions égales, comme lors du calcul du nombre de colonnes, de rangées ou de groupes dans une page. Cela aide à générer dynamiquement des structures de grille, d'affichage ou de pagination.
• Combinable avec d'autres filtres pour des résultats plus précis : Le filtre divided_by peut être utilisé en conjonction avec round, ceil ou floor pour ajuster le résultat selon les besoins. Cela permet d'obtenir un affichage arrondi ou tronqué selon le contexte fonctionnel ou esthétique.
• Peut générer des erreurs si le diviseur vaut zéro : Liquid ne gère pas toujours les divisions par zéro de manière explicite. Si le diviseur vaut 0, cela peut provoquer des comportements imprévisibles (retour nul ou message d'erreur). Il est donc recommandé de sécuriser la valeur avant usage.
• Pratique pour le calcul de pourcentages ou de moyennes simples : En combinant divided_by avec des multiplicateurs (times), on peut facilement afficher des pourcentages ou des moyennes à partir de données brutes. C'est particulièrement utile dans des tableaux de bord ou des interfaces de suivi.
• Fonctionne avec les entiers et les décimaux sans distinction stricte : Le filtre accepte aussi bien les entiers que les nombres à virgule flottante. Toutefois, le résultat sera en nombre flottant si au moins un des deux paramètres l'est, ce qui permet une flexibilité dans le traitement des données financières ou statistiques.
• Simplifie les calculs sur des données issues de listes ou d'objets : On peut très bien utiliser ce filtre sur des variables extraites de collections (comme products.size | divided_by: 2) pour créer des divisions logiques dans une interface, comme couper une liste en deux colonnes ou parties égales.
• Optimise les performances en évitant des traitements côté serveur : En réalisant directement certaines divisions dans Liquid, on réduit le besoin d'effectuer ces calculs en amont (exemple dans un plugiciel ou un script à distance). Cela peut accélérer le rendu et simplifier la logique métier côté serveur.