extends

Syntaxe

Paramètres

Description

Cette balise permet de créer un fichier Liquid basé sur un modèle parent (héritage de gabarits).

Remarques

• Permet l'héritage de gabarits pour factoriser le code : La balise {% extends %} sert à créer un modèle Liquid héritant d'un autre fichier modèle (gabarit parent). Cela permet de centraliser les éléments communs (en-têtes, pied de page, navigation) dans un seul fichier parent, évitant ainsi la duplication de code dans chaque page.
• Favorise la structure modulaire et réutilisable des pages : En désignant un gabarit parent, chaque page peut ne contenir que son contenu spécifique, tandis que l'habillage général est maintenu dans le gabarit étendu. Ce modèle est très utile dans les sites complexes comportant de nombreuses pages similaires.
• Utilisé en combinaison avec la balise block : L'usage de extends suppose que le gabarit parent contient des blocs {% block nom %} étant remplis ou remplacés dans les gabarits enfants. Cela permet d'insérer dynamiquement du contenu spécifique sans réécrire toute la structure HTML.
• Encourage une séparation claire entre structure et contenu : Grâce à extends, les développeurs peuvent isoler la structure visuelle (design) dans le gabarit parent, tandis que les pages enfants se concentrent uniquement sur le contenu dynamique ou contextuel. Cela améliore la lisibilité et la maintenabilité du code.
• Facilite la maintenance à long terme des portails Power Pages : Lorsqu'un changement de style ou de structure globale est requis, il suffit de modifier le gabarit parent, et toutes les pages l'étendant bénéficieront automatiquement de la mise à jour. Cela permet un gain de temps considérable.
• Le nom du gabarit parent est une chaîne entre guillemets : Le paramètre de la balise extends doit obligatoirement être une chaîne entre guillemets représentant le nom du fichier de gabarit parent. Une erreur dans le nom ou un oubli de guillemets entraînera une défaillance du rendu de la page.
• Requiert une organisation logique des fichiers Liquid : L'utilisation efficace de extends suppose que les gabarits soient bien nommés et organisés dans l'arborescence du site. Les gabarits parents doivent contenir des block nommés de manière cohérente pour permettre l'extension fluide par les enfants.
• Fonctionne selon le principe de surdéfinition contrôlée : Lorsqu'un fichier enfant étend un gabarit parent, il peut redéfinir certains blocs mais pas l'intégralité du contenu. Cela permet de conserver une base commune tout en laissant de la flexibilité pour les variations spécifiques à chaque page ou section.