replace_first

Syntaxe

Paramètres

Description

Ce filtre permet de remplacer uniquement la première occurrence d'une sous-chaîne de caractères.

Remarques

• Limité à une seule occurrence : Le filtre replace_first ne remplace que la toute première occurrence de la sous-chaîne ciblée dans la chaîne d'origine. C'est particulièrement utile lorsqu'on souhaite préserver les occurrences suivantes ou signaler uniquement la première apparition d'un terme dans un message.
• Comportement sensible à la casse : Comme pour le filtre replace, le remplacement opéré par replace_first est sensible à la casse. Cela signifie que "Bonjour" et "bonjour" sont traités comme deux chaînes différentes, ce qui peut nécessiter une normalisation (via downcase, par exemple) avant usage.
• Utile pour des ajustements progressifs : Dans des cas où l'on veut remplacer progressivement des éléments dans une chaîne, replace_first permet d'appliquer un traitement itératif ou conditionnel. Cela peut être utile dans les boucles ou lorsqu'on veut garder une trace de la modification.
• Peut être combiné avec des boucles pour remplacer plusieurs occurrences une par une : Bien qu'il ne remplace qu'une seule fois, on peut utiliser replace_first à l'intérieur d'une boucle Liquid pour appliquer plusieurs remplacements successifs. Cela offre un contrôle fin sur le nombre d'occurrences modifiées, ce que replace ne permet pas.
• Fonctionne aussi avec des chaînes vides : Il est possible d'utiliser une chaîne vide comme valeur de remplacement. Cela revient alors à supprimer uniquement la première occurrence de la sous-chaîne recherchée, ce qui peut servir pour nettoyer des doublons partiels ou ajuster une mise en forme.
• Ne modifie pas la chaîne d'origine : Comme tous les filtres Liquid, replace_first est non destructif : la chaîne originale reste intacte, et seule la valeur retournée est modifiée. Cela permet d'utiliser l'ancienne et la nouvelle version de la chaîne indépendamment l'une de l'autre.
• Incompatible avec des correspondances partielles ou floues : Le filtre attend une correspondance exacte avec la sous-chaîne spécifiée. Il ne prend pas en compte des variantes partielles, des caractères proches ou des expressions régulières. Cette simplicité facilite son usage, mais peut limiter sa puissance.
• Idéal pour manipuler du contenu structuré manuellement : Lorsqu'on travaille avec du texte formaté comme des balises HTML, des modèles de contenu ou des chaînes typées (exemple : logs, paramètres), replace_first peut servir à neutraliser ou modifier un seul élément ciblé sans affecter le reste du contenu.