strip_newlines |
Nouvelle ligne |
| Liquid (Microsoft) |
Syntaxe
|
{{ string | strip_newlines }}
|
Paramètres
| Nom |
Description |
| string |
Ce paramètre permet d'indiquer la chaîne de caractères dans laquelle tous les retours à la ligne (sauts de ligne) doivent être supprimés. |
Description
Ce filtre permet de supprimer tous les retours à la ligne d'une chaîne.
Remarques
- Utile pour les formats d'affichage linéaires : Le filtre strip_newlines est particulièrement utile lorsque l'on souhaite présenter une chaîne de
texte sur une seule ligne, par exemple dans une balise HTML <title>, un champ de
tableau ou une alerte. Il garantit un rendu sans saut intempestif.
- Facilite la concaténation de texte : En supprimant les sauts de ligne, ce filtre permet de fusionner plusieurs lignes en une seule, ce qui peut être utile
lorsqu'on regroupe des morceaux de texte issus de différentes sources (formulaires, contenus CMS,...).
- Prévient les erreurs d'affichage dans certaines composantes : Certains éléments d'interface comme les boutons, les infobulles ou les liens ne supportent
pas bien les sauts de ligne. Utiliser strip_newlines permet de s'assurer que le texte s'intègre sans casser la mise en page.
- Ne modifie pas les espaces ou les tabulations : Le filtre ne supprime que les retours à la ligne (\n, parfois \r\n), mais laisse intacte la présence
d'espaces, tabulations ou autres caractères blancs. Cela peut conduire à des résultats visuellement inattendus si le texte comportait des indentations.
- Utile pour formater les données dans les URL ou les API : Quand on utilise une chaîne de texte dans une requête d'URL ou un appel API, il est crucial
qu'elle ne contienne aucune rupture de ligne. strip_newlines aide à s'assurer que le format est propre et prêt à l'envoi.
- À ne pas confondre avec strip ou strip_html : Alors que strip supprime les espaces en début et fin de chaîne, et strip_html les balises
HTML, strip_newlines cible spécifiquement les sauts de ligne. Ces filtres peuvent être combinés pour un nettoyage plus
complet.
- Ne réduit pas la longueur de la chaîne de façon significative : Contrairement à ce que l'on pourrait penser, strip_newlines ne diminue pas
énormément la taille totale du contenu, sauf si celui-ci était massivement découpé en lignes. Il agit plus sur la forme du texte que sur son poids.
- Peut affecter la lisibilité du texte brut : Si le texte est destiné à être lu dans un contexte brut ou console, supprimer les retours à la ligne peut
rendre la lecture plus difficile, voire confuse. Il faut donc évaluer si cette transformation est appropriée au contexte d'affichage.
Dernière mise à jour : Jeudi, le 24 Juillet 2025