remove

Syntaxe

Paramètres

Description

Ce filtre permet de supprimer toutes les occurrences d'une sous-chaîne dans une chaîne.

Remarques

• Supprime toutes les occurrences, pas seulement la première : Le filtre remove élimine chaque apparition de la sous-chaîne spécifiée dans la chaîne source. Ce comportement est important à connaître, car si la sous-chaîne se répète plusieurs fois, elle sera supprimée partout, ce qui peut fortement modifier le texte final.
• La suppression est exacte et sensible à la casse : Le filtre ne fait pas de traitement intelligent : il supprime exactement ce qui est passé en paramètre. Par conséquent, remove: "ex" supprimera "ex" mais pas "Ex" ou "EX". Il faut donc faire attention à la casse si l'objectif est de nettoyer un texte sans distinction majuscule/minuscule.
• Peut être utilisé pour filtrer des symboles ou ponctuations : Le filtre remove est utile pour nettoyer une chaîne : on peut par exemple enlever des caractères inutiles (-, :, @, etc.) en les passant comme sous-chaîne. Cela peut être utile pour formater des données avant affichage ou traitement.
• N'altère pas la chaîne d'origine : Comme les autres filtres Liquid, remove n'édite pas la valeur d'origine : il renvoie une nouvelle chaîne sans la sous-chaîne ciblée, ce qui permet de l'utiliser en toute sécurité dans des transformations en chaîne, sans perdre l'entrée initiale.
• Peut supprimer des mots entiers ou des fragments partiels : Le filtre remove ne fait pas la distinction entre mots et fragments. Supprimer "cat" dans la phrase "catalogue" enlèvera également "cat" de "catalogue", donnant "alogue". Il faut donc être prudent lorsqu'on cible des séquences de lettres communes.
• Utile en combinaison avec d'autres filtres de nettoyage : On peut enchaîner remove avec d'autres filtres comme strip, replace, downcase,... Cela permet de créer des chaînes épurées et normalisées pour des besoins spécifiques comme des identifiants, des chemins ou des mots-clefs.
• Ne modifie pas les espaces autour de la sous-chaîne supprimée : Lorsqu'on supprime un mot, les espaces l'entourant restent inchangés, ce qui peut entraîner des doubles espaces ou des séparations visuellement incorrectes. Il peut être utile de combiner remove avec strip ou replace pour corriger cela.
• Ne gère pas les expressions régulières ou motifs complexes : Le filtre remove ne permet pas de supprimer une structure textuelle variable (comme un mot entre parenthèses, une balise HTML ou une date). Pour ce type de traitement, des filtres plus avancés ou un code côté serveur seraient nécessaires.