Introduction : Les balises Blogger / Blogger Tags

Les balises Blogger sont des balises d'instructions 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/>

Contrairement au langage HTML classique, elles sont sensibles à la casse et elles doivent être écrites exactement comme dans notre documentation.

On classifie ces balises dans 4 catégories distinctes :

• Balises de mise en page

  Permettent d'ajouter des sections et des gadgets.

• Balises du balisage par défaut

  Permettent de définir des inclusions par défaut et des inclusions communes spécifiques au thème courant.

• Balises d'habillage

  Contiennent les instructions d'habillage du thème (la feuille de styles et la définition des variables).

• Balises de widget

  Permettent de traiter les données, de créer des opérations, etc... Travaillent également dans l'ensemble du thème.

Les balises de mise en page

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

Balises	Description
<b:section>	La balise de 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
<b:widget>	La balise de gadget 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.

Le balisage par thème

Ces balises ont été conçues pour définir un balisage par défaut des gadgets. Lorsqu'un thème qui contient ces balises est installé, 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
<b:defaultmarkups>	Section de balisage Balise principale de la section du balisage par défaut du thème. Un thème peut contenir plusieurs sections de marquage. Cette balise ne peut contenir que des balises <b:defaultmarkup> (sans « s »).
<b:defaultmarkup>	Balisage par gadget 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
<b:skin>	Habillage global Ces balises contiennent les fichiers CSS et divers paramètres qui interagissent avec le concepteur de thèmes.
<b:template-skin>	Habillage thème 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
<b:includable> <b:include>	Inclure et 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
<b:widget-settings> <b:widget-setting>	Réglages des gadgets Ces balises ne peuvent être utilisées que dans une balise de widget. En savoir plus
<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, les noeuds enfants seront exécuté ou non. En savoir plus
<b:switch> <b:case> <b:default>	Commutateurs 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
<b:with>	Alias de variable Permet de créer une expression pouvant être employée dans les nœuds enfants. En savoir plus
<b:loop>	Boucle Permet d'accéder aux données contenues dans un tableau ou de créer une plage de nombres. En savoir plus
<b:comment>	Balise de commentaire HTML Permet d'ajouter un commentaire contenant des expressions Blogger. En savoir plus
<b:tag>	Balise de balise Permet d'ajouter une balise sous certaines conditions. En savoir plus
<b:attr>	Balise d'attribut Permet de générer des attributs dans la balise parente. En savoir plus
<b:class>	Balise de classe Permet de générer des valeurs « class » dans la balise parente. En savoir plus
<b:message> <b:param>	Balises Messages Permet de lire une donnée de type messages et d'ajouter des éléments. En savoir plus
<b:eval>	La balise d'évaluation d'expressions Permet d'afficher explicitement le résultat d'une expression. 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é dans les thèmes officiels Version 3. En savoir plus

Le Macro-Langage

Les balises du macro-langage sont des balises complémentaires au langage originel XML de Blogger. Ces balises sont utilisées uniquement dans les thèmes Version 2 pour gérer la disposition des colonnes.
Cette catégorie de balises étant en « fin de vie », Blogger Code PE ne fourni plus la documentation.

Balises	Description
<macro:...>	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 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 autres références XML

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

Retourner dans la Base de Connaissances