Les balises Blogger [introduction]

Nous vous rappelons que lorsque vous accédez à ce blog, vous signez automatiquement un accord avec Blogger Code.
Consultez les CGU.


Introduction aux balises Blogger
Les balises Blogger sont des balises spécifiques à l'éditeur XML de Blogger et ne peuvent être utilisées que dans celui-ci.


Classification des balises

La majorité des balises Blogger sont identifiables grâce au préfixe b:.

<b:tagName/>

Catégorie Description
Balises de mise en page Permettent d'ajouter des sections et des gadgets.
Balises de marquage Permettent de définir des inclusions par défaut et des inclusions communes.
Balises d'habillage Contiennent les styles d'habillage du thème.
Balises de widget Permettent de traiter les données, de créer des opérations, etc... Travaillent également dans l'ensemble du thème.
Macro Langage alternatif du b:language.
Cette catégorie de balises étant en "fin de vie", Blogger Code ne fourni plus la documentation.


Les balises de mise en page

On en dénombre 2 : <b:section> et <b:widget>. La première, crée des sections, tandis que l'autre affiche les gadgets dans ces sections.

Balises Description
La balise de section <b:section> La balise de section découpe le thème en section. Ces balises ne peuvent contenir que des balises <b:widget>.
En savoir plus
La balise de gadget <b:widget> Les balises de gadget sont imbriquées dans les balises <b:section>. Une balise de gadget ne peut contenir que des balises <b:includable>, dont une doit avoir l'identifiant main.
En savoir plus

Ce sont également ces balises qui permettent d'obtenir une représentation schématique du thème dans l'onglet "mise en page" dans l'interface.




Marquage par thème

Ces balises ont été conçues pour définir un marquage par défaut des gadgets. Lorsqu'un thème qui contient ces marquages est appliqué, ou lorsque le modèle de gadget est réinitialisé, ce sont les inclusions intégrées à l'intérieur de ces balises qui seront utilisées par défaut.
En savoir plus.
Balises Description
Section de marquage <b:defaultmarkups> Balise principale de la section de marquage.
Note: Un thème peut contenir plusieurs sections de marquage. Cette balise ne peut contenir que des balises <b:defaultmarkup> (sans "s").
Marquage par gadget <b:defaultmarkup> Ces balises contiennent les inclusions (<b:includable>) définies par défaut. Chaque balise est spécifique à 1 ou plusieurs gadgets. Ces balises ne peuvent être contenues que dans des balises <b:defaultmarkups> (avec "s").


Les balises d'habillage

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'usage du langage Blogger. A la place, un langage alternatif a été mis en place afin de pouvoir définir des variables et de les appliquer aux CSS.
En savoir plus
Balises Description
Habillage global <b:skin> Ces balises contiennent les fichiers CSS et divers paramètres qui interagissent avec le concepteur de thèmes.
Habillage thème <b:template-skin> A 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 widget

A l'origine prévues pour être fonctionnelles dans des gadgets (D'où le nom), ces balises peuvent être intégrées dans l'ensemble d'un thème. Elles ont chacune une fonction bien déterminée et sont dotées d'attributs qui permettent d'accueillir des expressions Blogger. Chaque expression renvoie un résultat que la balise exécute.

Balises Description
Inclure et Inclusion <b:includable>
<b:include>
Balises d'inclusion. Ces balises ne peuvent être utilisées que dans une balise de widget ou de marquage.
La balise <b:includable> divise le widget en une ou plusieurs sections et la balise <b:include> appelle une inclusion.
En savoir plus
Réglages des gadgets <b:widget-settings>
<b:widget-setting>
Balises de réglages du gadget. Ces balises ne peuvent être utilisées que dans une balise de widget.
En savoir plus
Conditions <b:if>
<b:elseif>
<b:else>
Balises conditionnelles. Ces balises contiennent une expression dont le résultat est une valeur booléenne.
Selon le résultat, le contenu imbriqué sera exécuté ou non.
En savoir plus
Interrupteurs <b:switch>
<b:case>
<b:default>
Balises interrupteurs. Ces balises ont un rôle similaire aux balises conditionnelles, à la différence près, que le résultat n'est pas limité à une valeur booléenne.
En savoir plus
Alias <b:with> Alias de variable. Permet de créer une expression pouvant être employée dans les nœuds enfants.
En savoir plus
Boucle <b:loop> Boucle. Permet d'accéder aux données contenues dans un tableau.
En savoir plus
Commentaires <b:comment> Balise de commentaire. Permet d'ajouter un commentaire contenant des expressions Blogger. En savoir plus
Ajouter une balise <b:tag> Permet d'ajouter une balise sous certaines conditions. En savoir plus
Ajouter un attribut <b:attr> Balise d'attribut. Permet de générer des attributs dans la balise parente.
En savoir plus
Ajouter une classe <b:class> Balise de class. Permet de générer des valeurs "class" dans la balise parente.
En savoir plus
Message permanent <b:message>
<b:param>
Balises Messages. Permet de lire une donnée de type messages et d'ajouter des éléments.
En savoir plus
Évaluation <b:eval> La balise d'évaluation d'expressions. Permet d'afficher explicitement le résultat d'une expression.
En savoir plus
Sortie des données <data:foo/> La balise de sortie des données. Affiche explicitement la valeur de la donnée.
En savoir plus
Scripts Blogger <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é dans les thèmes officiels Layouts Version 3.
En savoir plus


Macro

Balises utilisées dans les Layouts Version 2 pour gérer la disposition des colonnes.
Cette catégorie de balises étant en "fin de vie", Blogger Code ne fourni plus la documentation.

Balises Description
<macro:bloggerTagName> Langage alternatif du 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 dans les balises b:section.


Limitation

Le fichier XML peut exécuter jusqu'à 50 balises imbriqué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é.


Les autres références XML

Posts les plus consultés de ce blog