prepend

Syntaxe

Paramètres

Description

Ce filtre permet d'ajouter une chaîne au début d'une autre.

Remarques

• Ajout d'un préfixe sans altérer la valeur d'origine : Le filtre prepend permet d'ajouter une chaîne (appelée préfixe) au début d'une autre chaîne, sans modifier la valeur source de manière destructive. C'est particulièrement utile pour générer des identifiants ou préfixer dynamiquement des chemins ou des titres.
• Différent d'une concaténation classique par sa direction : Contrairement au filtre append, ajoutant du contenu à la fin d'une chaîne, prepend agit au début. Il permet donc une construction logique de chaînes lorsque l'ordre des éléments est important, comme pour des codes structurés (exemple : "INV-2025").
• Pratique pour insérer des balises HTML ou des classes CSS dynamiques : Dans un contexte de génération HTML dynamique, on peut utiliser prepend pour ajouter un préfixe à une classe CSS, un identifiant ou une balise. Par exemple : {{ 'btn' | prepend: 'primary-' }} devient primary-btn.
• Utile pour construire des URLs ou chemins relatifs : On peut utiliser ce filtre pour préfixer un chemin de fichier ou une URL avec un répertoire ou une base d'adresse. Par exemple, {{ 'images/photo.jpg' | prepend: '/assets/' }} retourne /assets/images/photo.jpg.
• Le préfixe est ajouté même si la chaîne source est vide : Si la valeur d'entrée (valeur) est vide, le filtre prepend retournera uniquement le préfixe. Cela peut être intentionnel ou non, et il peut être utile d'ajouter une vérification conditionnelle pour éviter des chaînes incomplètes ou mal formées.
• Fonctionne uniquement sur des chaînes de caractères : Le filtre prepend n'est pas destiné à des types numériques ou booléens. Si vous tentez de l'utiliser sur un entier, Liquid convertira implicitement la valeur en chaîne, ce qui peut générer des résultats inattendus dans certaines opérations de traitement de données.
• Sensible aux espaces et à la ponctuation du préfixe : Le filtre n'ajoute pas automatiquement d'espace entre le préfixe et la valeur. Il faut donc penser à inclure manuellement un espace ou un caractère séparateur, si nécessaire. Par exemple : prepend: 'Bonjour '.
• Peut être combiné avec d'autres filtres pour générer des résultats plus complexes : On peut utiliser prepend en combinaison avec des filtres comme upcase, replace ou strip pour formater dynamiquement des chaînes enrichies. Cela est utile pour la génération de contenus personnalisés dans des interfaces web ou des courriels automatisés.