newline_to_br

Syntaxe

Paramètres

Description

Ce filtre permet de convertir les retours à la ligne (\n) en balises <br> HTML.

Remarques

• Permet d'adapter un texte brut au format HTML : Ce filtre est particulièrement utile lorsqu'on affiche du contenu provenant de champs de saisie libre, comme des commentaires ou des descriptions. Il permet de préserver la mise en forme d'origine, en traduisant les sauts de ligne (\n) en balises HTML <br>, invisibles dans un rendu standard HTML sinon.
• Évite le recours à des balises HTML manuelles dans le contenu source : En utilisant newline_to_br, on n'a pas besoin que l'utilisateur insère manuellement des balises HTML dans ses textes pour créer des sauts de ligne. Cela rend l'expérience plus naturelle et sécurisée, tout en maintenant un rendu web cohérent.
• Prévient les affichages en bloc compact illisible : Sans ce filtre, les textes contenant plusieurs paragraphes ou lignes s'affichent en une seule ligne continue, ce qui rend la lecture difficile. Ce filtre améliore considérablement la lisibilité du contenu affiché sur une page.
• Particulièrement utile dans les formulaires et les blogs : Les champs de type textarea dans les formulaires ou les éditeurs de contenu acceptent des retours à la ligne. Grâce à newline_to_br, ces retours sont respectés dans l'affichage, ce qui est crucial dans les systèmes de commentaires, de blogs ou de documentation.
• Peut être combiné à d'autres filtres de nettoyage HTML ; Pour une sécurité renforcée, newline_to_br peut être utilisé après un filtre comme escape ou html_safe_escape, garantissant que seuls les sauts de ligne sont convertis, sans interprétation non désirée d'autres caractères HTML.
• N'a aucun effet si la chaîne ne contient pas de \n : Ce filtre ne modifie pas le texte si celui-ci ne contient aucun saut de ligne. Il est donc sûr à appliquer sur tous les textes, qu'ils contiennent ou non des retours à la ligne.
• Son effet est purement visuel, sans impact sur la structure des données : newline_to_br ne modifie pas la donnée source : il affecte uniquement l'affichage HTML du texte. Cela le rend idéal pour conserver la donnée brute intacte tout en assurant une présentation web propre et claire.
• Permet de respecter les intentions de mise en forme de l'utilisateur : Dans une interface web, un utilisateur s'attend généralement à ce que ses retours à la ligne soient visibles. Ce filtre reflète fidèlement l'intention de l'utilisateur, ce qui contribue à une expérience plus intuitive et respectueuse de son contenu.