plus

Syntaxe

Paramètres

Description

Ce filtre permet d'additionner une valeur numérique ou concaténer une chaîne à une autre.

Remarques

• Polyvalent : addition ou concaténation selon le type : Le filtre plus peut fonctionner de deux manières : s'il est utilisé avec des nombres, il effectue une addition arithmétique, tandis qu'avec des chaînes de caractères, il concatène les deux valeurs. Ce comportement dépend du type de la valeur de départ.
• Facilite l'incrémentation directe dans les modèles : Lorsqu'il est appliqué à des valeurs numériques, plus permet d'effectuer une incrémentation sans créer de variable intermédiaire. Par exemple, {{ 5 | plus: 2 }} donne directement 7, ce qui est utile pour afficher des calculs simples dans des gabarits.
• Comportement dynamique selon la donnée reçue : Le filtre ne force pas la conversion d'un type à un autre. Si valeur1 est une chaîne ("abc") et valeur2 un nombre (2), le résultat sera "abc2". Ce comportement implicite peut être pratique, mais aussi générer des surprises si les types ne sont pas bien contrôlés.
• Utile dans les boucles pour construire du contenu progressif : En concaténant des chaînes ou en augmentant des valeurs numériques, plus peut être intégré dans des boucles Liquid (for) pour composer dynamiquement du texte ou des valeurs agrégées, comme des identifiants, des totaux ou des balises.
• Fonctionne aussi avec des valeurs de variables : Le filtre accepte non seulement des valeurs fixes, mais aussi des variables, ce qui permet d'ajuster dynamiquement les résultats selon le contexte du rendu. Par exemple : {{ total | plus: ligne.montant }} pour ajouter un montant dans une boucle.
• Moins lisible que l'opérateur assign pour des traitements complexes : Bien qu'utile, l'usage répété de plus dans des expressions imbriquées peut nuire à la clarté du code Liquid. Pour des opérations successives, il est préférable d'entreposer le résultat dans une variable via assign.
• Ne produit pas d'erreur explicite en cas de type incompatible : Contrairement à des langages plus stricts, Liquid ne génère pas forcément d'erreur lors de combinaisons douteuses, comme {{ true | plus: 1 }}. Ce comportement peut masquer des incohérences si les types ne sont pas validés en amont.
• Permet d'enrichir dynamiquement des URLs ou du contenu HTML : En mode concaténation, plus est très pratique pour composer dynamiquement des liens ou des attributs HTML, par exemple : {{ '/produit/' | plus: produit.id }} pour créer un lien dynamique vers un élément identifié.