Introduction : Les balises Blogger / Blogger Tags

Les balises XHTML Blogger constituent un ensemble d'instructions spécifiques à l'éditeur XML de la plateforme Blogger, permettant une personnalisation avancée des thèmes et du contenu à travers une manipulation fine de la structure du document. Ces balises sont exclusivement utilisables dans l'éditeur XML, offrant ainsi une flexibilité surpassant celle des langages de balisage traditionnels, grâce à leur capacité d'intégrer des fonctionnalités dynamiques propres au framework Blogger.

La Classification des Balises

La plupart des balises se distinguent par le préfixe b:, qui signale leur appartenance à la spécification XML de Blogger.

<b:tagName/>

Contrairement aux balises HTML classiques, les balises sont sensibles à la casse et, étant en XHTML, elles sont également plus strictes. Cela signifie qu'elles doivent être rédigées conformément à la syntaxe exacte fournie dans notre documentation, sous peine de ne pas être reconnues ou de générer des erreurs de compilation, compromettant ainsi la robustesse de la structure du thème.

Les balises se répartissent en quatre catégories principales, chacune jouant un rôle spécifique dans la structuration et personnalisation du thème :

• Balises d'Habillage du thème

  Les balises d'habillage sont dédiées à la gestion des aspects esthétiques du thème, notamment via l'intégration de feuilles de style et la définition de variables. Elles jouent un rôle déterminant dans la personnalisation visuelle du thème, permettant aux développeurs de définir des styles génériques et des règles de présentation applicables de manière cohérente à l'ensemble des éléments.

• Balises de Structuration du Thème

  Les balises de mise en page ont pour fonction principale de structurer la présentation visuelle du blog. Elles permettent l'insertion de sections et de gadgets, offrant ainsi un contrôle précis sur la disposition des éléments constituant le thème.

• Balises de Configuration et de Structure des Widgets

  Ces balises sont utilisées pour définir la structure interne des widgets et contrôler leur configuration par défaut. Elles permettent de créer des composants modulaires et réutilisables au sein des gadgets, facilitant ainsi la maintenance et la personnalisation du thème.

• Balises de Logique et de Dynamisme

  Les balises de logique et de dynamisme sont particulièrement polyvalentes, car elles permettent non seulement d'effectuer des traitements sur les données, mais aussi d'intégrer des fonctionnalités dynamiques et interactives. Ces balises sont essentielles pour le développement de thèmes enrichis, capables de répondre aux besoins spécifiques des utilisateurs en termes de personnalisation et d'interaction.

Les Balises d'Habillage du Thème

Les balises d'habillage définissent les aspects esthétiques et stylistiques du thème Blogger. Ces balises ont été conçues pour interagir avec le concepteur de thèmes et les fichiers CSS. Ce sont les seules balises de toute la gamme qui ne permettent pas l'intégration des balises traditionnelles du langage Blogger. À la place, un langage alternatif a été créé afin de pouvoir définir des variables et de les appliquer aux CSS.

En savoir plus

Balises	Description
<b:skin>	Habillage global Contient les fichiers CSS ainsi que les variables permettant d'interagir avec le concepteur de thèmes.
<b:template-skin>	Habillage thème À l'origine, prévue pour gérer la disposition des colonnes, cette balise permet également de contenir des CSS influençant la mise en page dans le tableau de bord.

Les Balises de Structuration du Thème

Le fichier du thème repose principalement sur deux balises fondamentales pour la mise en page : <b:section> et <b:widget>. La balise <b:section> est utilisée pour définir des segments structurels au sein du corps de la page, tandis que la balise <b:widget> permet d'insérer des gadgets dans ces segments.

Balises	Description
<b:section>	La balise de section Segmente le thème en différentes sections, chacune incluant principalement des balises <b:widget>, bien que d'autres balises puissent également être autorisées dans ce nœud. En savoir plus
<b:widget>	La balise de gadget Intègre des gadgets au sein des sections définies. Ces gadgets peuvent contenir des balises <b:includable> et <b:widget-settings>, qui sont les seuls nœuds enfants autorisés. En savoir plus

Ces balises sont essentielles pour établir l'organisation visuelle du thème et permettent d'obtenir une représentation hiérarchique du thème dans l'interface de mise en page.

Les Balises de Configuration et de Structure des Widgets

Ces balises sont employées pour définir la structure interne des widgets et régir leur configuration par défaut. Elles permettent la création de composants modulaires et réutilisables, facilitant la maintenance, l'extensibilité et la personnalisation du thème. Cette approche modulaire aide à réduire les risques d'introduction de bugs et permet des modifications sans perturber l'intégrité globale du système, garantissant ainsi une gestion optimisée et flexible des éléments du thème.

Balises	Description
<b:includable> <b:include>	Inclusion La plupart de ces balises ne peuvent être utilisées que dans une balise de widget ou de balisage par défaut. La balise <b:includable> divise le widget en une ou plusieurs sections et la balise <b:include> appelle une inclusion. En savoir plus
<b:widget-settings> <b:widget-setting>	Réglages des gadgets Elles conservent les paramètres spécifiques d'un gadget, permettant un contrôle granulaire de ses options configurables. Ces balises sont automatiquement ajoutées à l'intérieur d'une balise <b:widget>. En savoir plus
<b:defaultmarkups> <b:defaultmarkup>	Balisage par défaut <b:defaultmarkups> est une balise englobante qui regroupe l'ensemble des balises de balisage par défaut pour les gadgets. Tandis que <b:defaultmarkup> spécifie les inclusions par défaut propres à un ou plusieurs gadgets. En savoir plus

Les Balises de Logique et de Dynamisme

Ces balises peuvent être intégrées dans l'ensemble d'un thème. Chacune possède une fonction bien définie et est dotée d'attributs permettant d'accueillir des expressions Blogger. Chaque expression produit un résultat que la balise exécute, offrant ainsi une grande souplesse dans la personnalisation des fonctionnalités des widgets.

Balises	Description
<b:if> <b:elseif> <b:else>	Balises conditionnelles Balises conditionnelles permettant d'exécuter des blocs de contenu en fonction de l'évaluation d'une expression booléenne. En savoir plus
<b:switch> <b:case> <b:default>	Commutateurs Balise conditionnelle permettant de gérer plusieurs cas d'utilisation de manière structurée. En savoir plus
<b:with>	Alias de variable Crée un alias pour une variable qui peut être utilisée dans les nœuds enfants. En savoir plus
<b:loop>	Boucle Crée des boucles pour itérer sur des tableaux de données ou générer des séquences de nombres. En savoir plus
<b:comment>	Balise de commentaires HTML Affiche des commentaires pouvant contenir des expressions Blogger exécutables, destinés aux développeurs, facilitant ainsi la documentation interne du code. En savoir plus
<b:tag>	Balise de balise Génère dynamiquement une balise en fonction de certaines conditions définies. En savoir plus
<b:attr>	Balise d'attribut Crée dynamiquement des attributs au sein de la balise parente. En savoir plus
<b:class>	Balise de classe Ajoute dynamiquement des classes CSS à la balise parente. En savoir plus
<b:message> <b:param>	Balises Messages Lit des données de type message et les rend accessibles dans la langue du bloc. En savoir plus
<b:eval>	La balise d'évaluation d'expressions Évalue explicitement une expression et en affiche le résultat. En savoir plus
<data:foo/>	La balise de sortie des données Affiche explicitement la valeur de la donnée. En savoir plus
<b:template-script>	Balise de script Permet de générer une balise script et de récupérer un fichier JS hébergé du côté de Blogger. Est essentiellement utilisée dans les thèmes officiels Version 3. En savoir plus

Le Macro-Langage

Les balises du macro-langage sont des extensions complémentaires du langage XML originel de Blogger exclusivement utilisées dans les thèmes Version 2 pour gérer la disposition des colonnes.

Cette génération de thèmes devenant vieillissante, Blogger Code PE ne fournit plus de documentation à leur sujet.

Balises	Description
<macro:...>	Langage alternatif au b:language. Le préfixe b: des balises de widget est remplacé par le préfixe macro:.
<b:section-contents>	Balises générées automatiquement dans le pied du fichier XML, qui classent les widgets au sein des balises b:section.

Limitation

Le fichier XML peut exécuter jusqu'à 50 balises d'instructions imbriquées (Les balises <b:include> et <b:includable> ne sont pas comptabilisées).

Si la limite est atteinte :

• En dehors des gadgets

  Le thème renverra une erreur.

• Dans un gadget

  L'inclusion ne sera pas exécutée.

Les Références XML

• Les balises
• Les attributs des balises
• Les types de données
• Les réglages des données
• Les opérateurs

Base de Connaissances