block

Syntaxe

Paramètres

Description

Cette balise permet de définir une section de contenu qui peut être remplacée ou étendue dans un fichier hérité.

Remarques

• Fondement de l'héritage de gabarit : La balise block est essentielle pour le mécanisme d'héritage dans Liquid. Elle permet à un fichier enfant d'écraser ou d'étendre une section spécifique d'un fichier parent. Cela favorise la réutilisation du code et permet d'avoir des mises en page centralisées et modulables.
• Nom du bloc comme identifiant unique : Chaque bloc doit porter un nom unique dans un même gabarit pour éviter les conflits. Ce nom agit comme une ancre que les fichiers enfants peuvent cibler pour injecter ou remplacer du contenu. Des noms cohérents facilitent la maintenance et la compréhension du code.
• Contenu par défaut utilisé si non redéfini : Si un fichier enfant n'écrase pas un bloc donné, le contenu par défaut défini dans le block sera utilisé. Cela garantit que le rendu ne sera jamais vide ou cassé, même si aucun remplacement explicite n'est fait.
• Interaction avec la balise extends : La balise block ne fonctionne correctement que dans le cadre d'un système utilisant extends. Le fichier de base définit les blocs, tandis que les fichiers enfants les redéfinissent. Cette relation crée une structure hiérarchique propre aux modèles complexes.
• Clarté de l'organisation du contenu : Utiliser des blocs nommés permet de structurer clairement le contenu d'un fichier. On peut facilement identifier les zones qui peuvent être personnalisées, comme header, main, sidebar, ou footer, rendant la lecture du code plus intuitive.
• Possibilité d'insérer du contenu dynamique : Le contenu par défaut d'un bloc peut inclure des balises ou filtres Liquid. Cela permet d'afficher dynamiquement des données, même lorsque le bloc n'est pas surchargé. Ainsi, les blocs ne sont pas limités à du texte statique.
• Comportement utile pour des thèmes personnalisables : Dans un contexte comme Power Pages ou un CMS basé sur Liquid, les blocs sont particulièrement utiles pour permettre à des utilisateurs ou développeurs d'insérer du contenu propre sans modifier la structure principale du site. C'est un outil de personnalisation puissant.
• Complémentarité avec d'autres balises Liquid : La balise block fonctionne souvent en conjonction avec d'autres balises comme include, if, ou for, pour rendre les modèles dynamiques. Elle peut contenir toute logique Liquid valide, ce qui permet une grande flexibilité dans la conception de pages héritées.