Introduction : Les balises Blogger / Blogger Tags

Introduction aux 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.



Spotlight

Populaires cette semaine