text_to_html |
Texte à HTML |
| Liquid (Microsoft) |
Syntaxe
|
{{ texte | text_to_html }}
|
Paramètres
| Nom |
Description |
| texte |
Ce paramètre permet d'indiquer le texte brut qui doit être transformé en HTML, en convertissant les retours à la ligne en balises <p> et <br>. |
Description
Ce filtre permet de transformer du texte brut en HTML, en convertissant les retours à la ligne en paragraphes et <br>.
Remarques
- Facilite la mise en forme automatique du texte brut : Le filtre text_to_html est particulièrement utile lorsqu'on reçoit du contenu en texte brut,
comme des champs de formulaire ou des extraits de base de données, et que l'on souhaite le rendre lisible en HTML sans intervention manuelle.
- Convertit les retours à la ligne en balises HTML : Ce filtre transforme chaque double saut de ligne en une balise <p>
(paragraphe), et chaque simple saut de ligne en une balise <br>, ce qui permet de conserver l'intention de mise en forme
initiale tout en respectant les standards du web.
- Évite d'écrire du HTML à la main dans les contenus : Grâce à text_to_html, les auteurs de contenu peuvent écrire en texte simple, sans balises
HTML, tout en obtenant automatiquement une mise en forme correcte. Cela est idéal pour des interfaces simplifiées côté
utilisateur ou administrateur.
- N'ajoute pas de balises supplémentaires si le texte est déjà en HTML : Le filtre est prévu pour du texte brut, et non du
HTML existant. Si on l'applique à une chaîne contenant déjà des balises HTML, cela pourrait entraîner une mise en forme
incorrecte ou redondante, il faut donc l'utiliser avec précaution.
- Améliore l'affichage sur le web tout en conservant la sémantique : En convertissant les sauts de ligne en éléments
HTML structurels comme <p> et <br>,
text_to_html respecte la structure logique du contenu, ce qui est bénéfique pour la lisibilité, l'accessibilité et le référencement.
- Peut être utile dans les blogs, commentaires ou messages utilisateur : Lorsqu'un site permet à des utilisateurs de saisir du texte libre, comme des
commentaires ou des biographies, ce filtre permet de présenter ce contenu de manière propre, même s'il n'est pas formaté par l'utilisateur lui-même.
- Doit être combiné avec un échappement HTML si nécessaire : Si le texte contient des caractères spéciaux (<, >, &,...), il peut être judicieux
d'utiliser un filtre d'échappement HTML en amont, pour éviter que du HTML non désiré soit interprété. text_to_html ne fait pas
ce nettoyage automatiquement.
- N'est pas destiné à la conversion complète de documents structurés : Ce filtre n'est pas conçu pour transformer un texte complexe (avec titres, listes,
tableaux...) en HTML complet. Il s'agit d'un convertisseur léger, principalement orienté vers la séparation de paragraphes
et de lignes simples.
Dernière mise à jour : Jeudi, le 24 Juillet 2025