include

Syntaxe

Paramètres

Description

Cette balise permet d'insérer un autre fichier Liquid ou un fragment réutilisable dans la page courante.

Remarques

• Facilite la réutilisation de code entre plusieurs pages : La balise {% include %} permet de centraliser des portions de code Liquid communes dans des fichiers séparés. Cela évite la duplication de code dans plusieurs pages et rend les modifications plus faciles à maintenir.
• Soutient une architecture modulaire dans les portails Power Pages : En utilisant include, les développeurs peuvent structurer leurs pages en composantes réutilisables (entêtes, pieds de page, blocs d'alerte,...). Cela améliore la clarté et la cohérence du code, en particulier dans les projets à grande échelle.
• Prend en charge les noms de fichiers statiques ou dynamiques : Le nom du fichier à inclure peut être spécifié directement ("footer") ou déterminé dynamiquement par une variable (include fichier_a_inclure). Cela permet de charger un fragment différent en fonction du contexte ou des paramètres.
• Le fichier inclus doit être un fragment Liquid valide : Le fichier appelé par include doit être un fragment correctement structuré, sans balises redondantes (html, body,...) si l'on l'intègre dans un gabarit déjà complet. Ce fichier est inséré tel quel dans le flux Liquid de la page.
• Ne permet pas de passer directement des paramètres personnalisés : Contrairement à d'autres moteurs de gabarits comme Jinja ou Twig, Liquid ne prend pas en charge le passage explicite de paramètres à une inclusion. Les fragments inclus accèdent aux mêmes variables que la page parente.
• Utile pour séparer la logique Liquid de la présentation HTML : L'utilisation d'include permet de déplacer la logique Liquid (conditions, boucles, affichage de données) dans des fichiers spécifiques, laissant le gabarit principal plus lisible et focalisé sur la structure générale de la page.
• Fonctionne bien avec d'autres balises comme if ou for : Un fragment peut être inclus à l'intérieur d'une condition {% if %} ou d'une boucle {% for %}. Cela permet par exemple d'afficher un fragment seulement pour certains éléments d'une collection ou selon le rôle d'un utilisateur.
• Favorise la maintenance à long terme et le travail collaboratif : En scindant les gabarits en fragments réutilisables avec include, plusieurs développeurs peuvent travailler sur des parties spécifiques du portail sans risque de conflits. Cela améliore la productivité et réduit les erreurs dans des équipes multidisciplinaires.