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

Blogger - La balise de gadget <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>


Spotlight

Populaires cette semaine