append

Syntaxe

Paramètres

Description

Ce filtre permet de concaténer une chaîne de texte à la fin d'une autre.

Remarques

• Permet de concaténer simplement des chaînes de caractères : Le filtre append est utilisé pour ajouter du texte à la fin d'une chaîne existante. Il est particulièrement utile dans les scénarios où l'on souhaite construire dynamiquement du contenu textuel sans devoir écrire de logique conditionnelle complexe.
• Fonctionne aussi bien avec des chaînes statiques qu'avec des variables : La valeur ajoutée peut être une chaîne littérale ("px", " - nouveau"), mais aussi une variable, ce qui permet de fusionner dynamiquement des données provenant de différents contextes (exemple : nom d'utilisateur, numéro, ID...).
• Peut servir à créer des classes CSS ou des identifiants HTML dynamiques : En assemblant des fragments de texte, append permet de générer des noms de classes CSS ou des ID uniques, en fonction de conditions ou de boucles. Cela améliore la flexibilité dans la construction d'éléments HTML personnalisés.
• Peut être combiné avec des filtres comme replace, downcase, capitalize : Le résultat d'un append peut être modifié ensuite avec d'autres filtres pour appliquer des règles de style ou de format (par exemple, transformer un texte en minuscules après concaténation, ou ajouter un suffixe formaté à un nom).
• Utile dans la génération d'URLs ou de chemins de fichiers : Lorsque vous devez générer des liens dynamiques ou des chemins vers des ressources, append permet d'ajouter des segments à une URL de base, comme /documents/ + nom_de_fichier.pdf, sans manipulations compliquées.
• Peut être enchaîné plusieurs fois pour assembler des blocs de texte : Il est possible d'utiliser plusieurs filtres append successifs pour construire une chaîne plus complexe étape par étape, ce qui est pratique lorsque le contenu dépend de plusieurs conditions ou variables.
• Ne modifie pas la variable d'origine : Comme pour tous les filtres Liquid, append ne modifie pas directement la variable initiale. Il retourne une nouvelle valeur modifiée, ce qui permet d'enchaîner des transformations sans affecter la donnée de départ.
• Attention aux types de données non textuels : Même si append est tolérant, lorsqu'il est utilisé avec des types non textuels (nombres, booléens, objets), ceux-ci sont convertis automatiquement en chaîne de caractères. Il faut donc vérifier le format pour éviter des résultats inattendus dans le rendu.