raw

Syntaxe

Paramètres

Description

Cette balise permet d'inclure du texte brut ou du code HTML sans être interprété comme Liquid.

Remarques

• Utile pour afficher du code sans exécution Liquid : La balise {% raw %} permet d'écrire du contenu dans un fichier Liquid sans que celui-ci soit interprété comme une instruction. C'est essentiel pour afficher des exemples de syntaxe ou du code source contenant des balises Liquid ({{ ... }} ou {% ... %}) sans qu'elles soient exécutées.
• Pratique pour documenter des gabarits Liquid dans une page : Dans les portails Power Pages, on peut vouloir expliquer le fonctionnement de certains blocs de code Liquid. La balise raw permet d'écrire ce code d'exemple tel quel, ce qui facilite la documentation interne ou la formation des éditeurs de contenu.
• Compatible avec le HTML et le JavaScript : Cette balise est particulièrement utile lorsqu'on veut insérer du code HTML, CSS ou JavaScript dans un modèle sans risquer que les accolades ou balises soient mal interprétées. Cela protège aussi les scripts d'une interprétation accidentelle.
• Elle empêche l'évaluation de toute logique Liquid à l'intérieur du bloc : Tout le contenu placé entre {% raw %} et {% endraw %} est ignoré par le moteur Liquid. Cela inclut les variables, conditions, boucles, ou inclusions. Rien ne sera exécuté, même si le contenu est syntaxiquement valide.
• Peut poser problème si utilisée autour d'un bloc trop large par erreur : Un usage imprudent de raw peut empêcher l'exécution normale du code. Par exemple, si on englobe accidentellement un bloc qui contient du contenu dynamique utile, celui-ci sera ignoré par le moteur Liquid et affiché tel quel, ce qui est rarement souhaité.
• Indispensable lors de l'affichage de fragments de Liquid dans des tutoriels : Pour les pages éducatives ou les guides de développement dans un portail, cette balise est incontournable. Elle permet d'afficher proprement des blocs de code explicatifs sans devoir échapper chaque caractère spécial individuellement.
• Elle ne prend pas de paramètres explicites mais agit comme un délimiteur : Contrairement à d'autres balises acceptant des paramètres (comme include, entityform,...), raw ne prend aucun paramètre. Son rôle est purement syntaxique : tout ce qui est entre l'ouverture et la fermeture est protégé de l'évaluation.
• Favorise la maintenance claire du code source dans des environnements complexes : Dans les cas où du contenu dynamique et statique cohabitent, l'utilisation judicieuse de raw peut éviter des conflits d'interprétation. Elle permet de bien isoler des blocs qui ne doivent en aucun cas être traités, améliorant ainsi la lisibilité et la stabilité du template.