La balise de gadget [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 Classification Préfixe « expr: » Signification -
id HTML classic interdit 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.
Obligatoire
title HTML classic interdit 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.
Obligatoire
type HTML classic interdit Le type du gadget.
Consultez l'introduction aux gadgets pour connaître le type d'un gadget.
Obligatoire
mobile HTML classic interdit Affichage du gadget dans la version 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.
Facultatif
locked HTML classic interdit 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.
Facultatif
cond XML Blogger Expression autorisé 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.
En savoir plus
Facultatif
visible HTML classic interdit 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 (Layouts Version 3 et Gadget Version 2)
Facultatif
version HTML classic interdit 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 essentiellement de la version du Layouts.
Note : Cet attribut peut ne pas apparaître dans le code XML, même si vous l'ajoutez manuellement.
Automatique
pageType Obsolète Obsolète 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


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

Spotlight

Les identifiants Blogger

Populaires cette semaine

Outils de sauvegarde et supression du blog

La confidentialité d'un blog et le contenu pour adultes