liquid

Syntaxe

Paramètres

Description

Ce filtre permet d'interpréter une chaîne comme du code Liquid et de l'exécuter dynamiquement.

Remarques

• Offre une syntaxe moderne et lisible pour écrire plusieurs instructions : Le bloc {% liquid %} permet d'écrire plusieurs instructions Liquid à la suite, de manière plus lisible et structurée que des blocs séparés {% assign %}, {% if %},... Cela rend le code plus clair dans des scénarios complexes, surtout avec des conditions ou des boucles imbriquées.
• Pratique pour regrouper les instructions dans une seule balise : Contrairement à l'approche traditionnelle où chaque instruction est entourée de sa propre paire {% %}, le bloc liquid regroupe toutes les instructions à l'intérieur d'un seul bloc. Cela réduit le bruit visuel dans le modèle et facilite la maintenance.
• Favorise les performances en évitant l'interprétation ligne par ligne : Ce bloc est plus performant, car le moteur Liquid peut interpréter et compiler les instructions à l'intérieur du bloc liquid en une seule passe. Cela réduit la surcharge de traitement, notamment dans des modèles rendus fréquemment.
• Compatible avec toutes les instructions classiques de Liquid : À l'intérieur du bloc liquid, on peut utiliser assign, if, case, for,..., exactement comme dans le reste du langage. Il n'y a aucune restriction de syntaxe, ce qui en fait un outil polyvalent pour les gabarits conditionnels ou logiques.
• Améliore la gestion des erreurs dans les blocs complexes : L'usage du bloc liquid permet une meilleure détection d'erreurs de syntaxe dans les éditeurs modernes. Comme toutes les instructions sont regroupées dans un seul bloc, il est plus facile de repérer une faute de frappe ou une mauvaise indentation.
• Idéal pour les blocs dynamiques dans Power Pages : Dans les portails Power Pages, le bloc liquid est souvent utilisé pour préparer des variables, faire des calculs ou appliquer des règles d'affichage selon des rôles, des contextes ou des valeurs d'entités Dynamics 365. Il centralise la logique métier dans un seul endroit du modèle.
• Permet l'exécution dynamique de chaînes de commandes : Même si le nom «liquid» peut porter à confusion avec le langage lui-même, ici, ce bloc permet d'exécuter plusieurs lignes comme du code actif, ce qui le distingue d'une simple interpolation ou d'un filtre. C'est donc un outil de traitement plutôt qu'un filtre d'affichage.
• Nécessite une attention particulière à l'indentation et à l'ordre : Comme les instructions sont empilées dans un même bloc sans balises fermantes (endif, endfor,...), la rigueur dans l'ordre et l'indentation est essentielle pour éviter les erreurs ou les effets inattendus. Cela demande un peu de discipline dans la rédaction.