La balise de gadget / The gadget tag : <b:widget>

La balise Blogger <b:widget> est un élément de mise en page, qui ne peut être contenue que dans une balise <b:section>.
Cette balise renferme le code xml du gadget.

La syntaxe

XML

<b:widget cond='true' id='Header1' locked='false' title='Blogger Code (Header)' type='Header'>

</b:widget>

• Chaque <b:widget> est imbriqué dans une balise <b:section>.

• Une balise <b:widget> ne peut contenir que des balises <b:includable>, dont une est obligatoire avec l'identifiant main.

• Les balises <b:widget> ne peuvent pas être imbriquées.

Les attributs

Plusieurs attributs peuvent être ajoutés dans la balise. Certains sont requis et d'autres sont facultatifs.

<b:widget id='WIDGET_ID'
          cond='TRUE|FALSE'
          locked='TRUE|FALSE'
          version='1|2'
          title='WIDGET_TITLE'
          type='WIDGET_TYPE'>

</b:widget>

Attributs	Description	Classification	Préfixe « expr: »	Implantation
id	Identifiant du gadget L'identifiant est composé du type du gadget, suivi d'un numéro entre 1 et 999. Consultez l'introduction aux gadgets pour connaître le type d'un gadget.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Obligatoire
title	Le titre du gadget Généralement, il s'agit du titre défini dans le panneau de configuration du gadget. L'attribut est obligatoire, mais la valeur peut rester vide. Longueur maximum autorisée : 100 caractères.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Obligatoire
type	Le type du gadget Consultez l'introduction aux gadgets pour connaître le type d'un gadget.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Obligatoire
mobile	Affichage Mobile Cette attribut défini l'affichage du gadget dans la vue mobile personnalisée. yes : Oui, le gadget s'affichera dans la version mobile et la version web. no : Non, le gadget s'affichera uniquement dans la version web. only : Le gadget s'affichera uniquement dans la version mobile. ATTENTION ! Cet attribut est actif uniquement avec les gadgets version 1.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Facultative
locked	Verrouillage du gadget Lorsque le gadget est verrouillé, l'utilisateur ne peut plus le supprimer, ni le déplacer dans la mise en page. L'attribut accepte également les valeurs yes|no qui deviennent respectivement true|false.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Facultative
cond	Condition d'exécution du gadget La valeur attendue doit être boolean (true ou false). Elle peut être une valeur explicite, une donnée universelle (ou issue du widget) ou une expression Blogger.	Classification : XML Blogger Expression	Préfixe « expr: » : Autorisé	Implantation : Facultative
visible	Visibilité du gadget true ou false. Réglage permettant de rendre le gadget actif. Si vrai, le gadget sera répertorié dans le dictionnaire universel data:widgets (Thèmes Version 3 et Gadget Version 2)	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Facultative
version	Numéro de version du gadget Valeur 1 ou 2. La valeur est définie automatiquement lors de l'intégration du gadget et dépend de la version du thème. Note : Cet attribut peut ne pas apparaître dans le code XML, même si vous l'ajoutez manuellement.	Classification : HTML classic	Préfixe « expr: » : Interdit	Implantation : Automatique
pageType	Condition d'affichage Utilisé dans les premiers thèmes pour afficher le widget sur les pages désignées, ce paramètre est aujourd'hui obsolète.	Obsolète	Obsolète	Obsolète

Rendu HTML de la balise

Lors de l'analyse du fichier, les balises <b:widget> sont converties. Les principales transformations dans le rendu HTML du blog sont :

• La balise <b:widget> est remplacée par une balise <div>.

• La balise <div> contiendra l'attribut id.

• L'attribut class est ajouté. Il contient la valeur widget et le type du gadget.

• L'attribut data-version mentionne la version du gadget.

XML

<b:widget id='Header1' locked='false' title='Blogger Code (Header)' type='Header' version='2'>

</b:widget>

Rendu HTML

<div class='widget Header' id='Header1' data-version='2'>

</div>

Les autres balises

• <b:attr>
• <b:class>
• <b:comment>
• <b:defaultmarkups>
<b:defaultmarkup>
• <b:eval>
• <b:if>
<b:elseif>
<b:else>
• <b:includable>
<b:include>
• <b:loop>
• <b:message>
<b:param>
• <b:section>
• <b:skin>
<b:template-skin>
• <b:switch>
<b:case>
<b:default>
• <b:tag>
• <b:template-script>
• <b:widget>
• <b:widget-settings>
<b:widget-setting>
• <b:with>
• <data:foo>
• <![CDATA[]]>

Retourner à l'introduction