data:widgets - Blogger Data Documentation
| Data Type | Gadget Version 1 | Gadget Version 2 |
|---|---|---|
| array[Object] | Inexistant | Global |
- Description de l'ensemble
data:widgetsest un tableau de données universelles regroupant diverses caractéristiques des gadgets Blogger visibles installés sur le blog.
Chaque donnée que nous avons répertorié dans notre sélection ci-dessous dispose d'une fiche technique sur ce blog. Dans chaque fiche, vous y trouverez des méthodes d'implantation, les différents réglages qui peuvent être appliqués et des exemples que vous pouvez importer directement dans votre blog de tests.- Intégration de l'ensemble dans le code XML
- Dans les nœuds enfants de la balise
<HTML>, à l'exception des marqueurs<![CDATA[ ]]>. - Directives d'usage et niveau de priorité de mise à jour
-
Thème Version 1Garantie d'usage : AucuneAucune prioritéThème Version 2Garantie d'usage : AucuneAucune prioritéThème DynamiqueGarantie d'usage : AucuneAucune prioritéThème Version 3Garantie d'usage : OuiPriorité haute
- Disponibilité par défaut par type de pages
- Toutes les pages.
- Longueur maximum de l'ensemble
- Indéfini.
- Set de réglages XML
- Disponible.
- Condition additionnelle
- Les gadgets doivent être visibles.
Ressources
Échantillonnage principal et les réglages du tableau
widgets: array,
size: number,
length: number,
empty: boolean,
notEmpty: boolean,
any: boolean,
first: object,
last: object
,
AdSense: array,
Attribution: array,
Blog: array,
BlogArchive: array,
BloggerButton: array,
BlogList: array,
BlogSearch: array,
ContactForm: array,
FeaturedPost: array,
Feed: array,
Followers: array,
Header: array,
HTML: array,
Image: array,
Label: array,
LinkList: array,
PageList: array,
PopularPosts: array,
Profile: array,
ReportAbuse: array,
Stats: array,
Subscribe: array,
Text: array,
TextList: array,
Translate: array,
Wikipedia: array
Échantillonnage des items du tableau - Tous les gadgets
widgets:
title: string,
type: string,
sectionId: string,
id: string
Échantillonnage des items du tableau - Gadget Blog
widgets:
title: string,
type: string,
sectionId: string,
id: string,
posts: array,
headerByline: object,
footerBylines: array,
allBylineItems: array
Échantillonnage des items du tableau - Gadget FeaturedPost
widgets:
title: string,
type: string,
sectionId: string,
id: string,
postId: number
Échantillonnage des items du tableau - Gadget PopularPosts
widgets:
title: string,
type: string,
sectionId: string,
id: string,
posts: array
Parenté - Enfant de :
- Global
widgets
Implantation du tableau
Syntaxe basique
<b:loop values='data:widgets' var='widget'> <!-- Tag --> <data:widget.ITEM_NAME/> <!-- Attribute value --> <b:eval expr='data:widget.ITEM_NAME'/> </b:loop>
Indice de l'item
<b:loop values='data:widgets' var='widget' index='i'> <!-- Index (number) --> <data:i/> <!-- Index [i] --> <b:eval expr='data:widgets[i].ITEM_NAME'/> <!-- Index [i+1] --> <b:with value='data:i + 1' var='next'> <b:eval expr='data:widgets[next].ITEM_NAME'/> </b:with> <!-- Index [i-1] --> <b:if cond='data:i gt 0'> <b:with value='data:i - 1' var='prev'> <b:eval expr='data:widgets[prev].ITEM_NAME'/> </b:with> </b:if> </b:loop>
L'indice est un nombre entier positif (0 compris) qui représente la position de l'élément dans un tableau. Il peut être intègré directement dans la donnée de cette manière : data:array[index].item. Quant à la donnée, elle doit obligatoirement être dans un attribut d'expression.
Dans notre exemple, nous utilisons l'indice pour retrouver l'élément courant [i], l'élément suivant [i+1] et l'élément précédant [i-1].
Sens inverse de la boucle
<!-- REVERSE EXPLICIT --> <b:loop values='data:widgets' var='widget' reverse='true'> <data:widget.ITEM_NAME/> </b:loop> <!-- REVERSE CONDITION --> <b:loop values='data:widgets' var='widget' expr:reverse='data:view.isPost'> <data:widget.ITEM_NAME/> </b:loop>
Le sens de lecture du tableau peut être inversé en injectant l'attribut reverse dans la balise <b:loop>. La valeur de l'attribut doit être true (vrai).
Dans nos exemples, nous utilisons 2 méthodes.
- La première, est une valeur explicite permanente.
- Dans la 2e méthode, nous ajoutons une expression booléenne qui inversera la boucle que si le résultat est vrai.
Les réglages du tableau
Les réglages sont des items contenus dans l'objet du tableau qui renvoient une nouvelle valeur. Dans la syntaxe, ils s'ajoutent à la suite du nom du tableau.
Introduction aux réglages des données
Les réglages autorisés pour ce tableau sont :
Filtre par type de widgets
<!-- WIDGET ADSENSE --> <b:loop values='data:widgets.AdSense' var='widget'></b:loop> <!-- WIDGET BLOG --> <b:loop values='data:widgets.Blog' var='widget'></b:loop> <!-- WIDGET FEATUREDPOST --> <b:loop values='data:widgets.FeaturedPost' var='widget'></b:loop> <!-- WIDGET POPULARPOSTS --> <b:loop values='data:widgets.PopularPosts' var='widget'></b:loop> <!-- WIDGET PROFILE --> <b:loop values='data:widgets.Profile' var='widget'></b:loop>
En appliquant le nom d'un type de gadget comme suffixe au tableau, le tableau ne contiendra plus que les gadgets de ce type. Dans notre exemple, nous filtrons les gadgets AdSense, Blog, FeaturedPost, PopularPosts et Profile.
Premier et dernier item du tableau
<!-- FIRST - ALL WIDGETS --> <b:eval expr='data:widgets.first.ITEM_NAME'/> <!-- LAST - ALL WIDGETS --> <b:eval expr='data:widgets.last.ITEM_NAME'/> <!-- FIRST - WIDGET BLOG --> <b:eval expr='data:widgets.Blog.first.ITEM_NAME'/> <!-- LAST - WIDGET BLOG --> <b:eval expr='data:widgets.Blog.last.ITEM_NAME'/>
first et last sont des filtres qui permettent d'obtenir respectivement le premier et dernier élément d'un tableau sans avoir à recourir à l'usage d'une boucle.
Ces réglages peuvent être également appliqués à la suite d'un filtre par gadget.
Longueur du tableau
<!-- WITH SIZE - ALL WIDGETS --> <data:widgets.size/> <!-- WITH LENGTH - ALL WIDGETS --> <data:widgets.length/> <!-- WITH SIZE - WIDGET BLOG --> <data:widgets.Blog.size/> <!-- WITH LENGTH - WIDGET BLOG --> <data:widgets.Blog.length/>
Les suffixes size et length permettent de connaître le nombre de set dans ce tableau. Le résultat sera une valeur numérique.
Ces réglages peuvent être également appliqués à la suite d'un filtre par gadget.
Ce tableau est vide ?
<!-- EMPTY - ALL WIDGETS --> <b:if cond='data:widgets.empty'></b:if> <!-- NOT EMPTY - ALL WIDGETS --> <b:if cond='data:widgets.notEmpty'></b:if> <!-- ANY - ALL WIDGETS --> <b:if cond='data:widgets.any'></b:if> <!-- EMPTY - WIDGET BLOG --> <b:if cond='data:widgets.Blog.empty'></b:if> <!-- NOT EMPTY - WIDGET BLOG --> <b:if cond='data:widgets.Blog.notEmpty'></b:if> <!-- ANY - WIDGET BLOG --> <b:if cond='data:widgets.Blog.any'></b:if>
Pour savoir si ce tableau n'est pas vide, appliquez le suffixe empty au tableau.
Pour vérifier si ce tableau contient des sets, appliquez les suffixes notEmpty ou any au tableau.
Quelque soit le suffixe, l'expression renverra une valeur booléenne.
Ces réglages peuvent être également appliqués à la suite d'un filtre par gadget.
Intégration dans des opérations
Des opérateurs peuvent traiter les tableaux et leur contenu. Le nombre de combinaisons étant très élevé, nous vous fournissons uniquement que quelques exemples basics.
Inclure les sets jusqu'à / à partir de
<!-- HALF ARRAY LENGTH (POSITIVE INTEGER) --> <b:with value='(data:widgets.length - (data:widgets.length % 2)) / 2' var='half'> <!-- TAKE (FIRST HALF) --> <b:loop values='data:widgets take data:half' var='widget'> <b:eval expr='data:widget.ITEM_NAME'/> </b:loop> <!-- SKIP (SECOND HALF) --> <b:loop values='data:widgets skip data:half + 1' var='widget'> <b:eval expr='data:widget.ITEM_NAME'/> </b:loop> </b:with>
take et skip sont deux opérateurs de tableaux qui permettent de contrôler le nombre de sets à inclure dans la boucle.
take inclu jusqu'au énième set, tandis que skip inclu à partir du énième set.
Dans notre exemple, nous divisons la longueur totale du tableau par 2 et nous traitons la 1ère moitié et la seconde moitié du tableau dans 2 boucles séparées.
Plage de nombres
<b:if cond='data:widgets.any'> <!-- CHRONOLOGICAL --> <b:loop values='0 to data:widgets.size - 1' var='number'> <b:eval expr='data:widgets[number].ITEM_NAME'/> </b:loop> <!-- REVERSE --> <b:loop values='data:widgets.size - 1 to 0' var='number'> <b:eval expr='data:widgets[number].ITEM_NAME'/> </b:loop> </b:if>
to est un opérateur qui génère une plage de nombres.
Dans cet exemple, nous utilisons l'opérateur comme indice. Ce qui permet de controler le sens de lecture de la boucle.
Opérations Lambdas
<!-- CONDITION --> <b:if cond='data:widgets all (widget => widget.ITEM_NAME)'></b:if> <!-- COUNT --> <b:eval expr='data:widgets count (widget => widget.ITEM_NAME)'/> <!-- FILTER --> <b:loop values='data:widgets where (widget => widget.ITEM_NAME)' var='widget'> <b:eval expr='data:widget.ITEM_NAME'/> </b:loop> <!-- MAPPING --> <b:loop values='data:widgets map (widget => widget.ITEM_NAME)' var='item'> <b:eval expr='data:item'/> </b:loop>
Un lambda est une expression qui évalue le contenu d'un tableau. Selon l'opérateur, on peut obtenir une condition, un compteur, un filtre ou un mappage d'après un ou plusieurs critères spécifiques au contenu de ce tableau.
Dans nos exemples, nous reprenons la syntaxe basique de chaque opérateur avec comme critère un quelconque item du tableau. Ce critère peut être une opération plus sophistiquée.
Récipients dans le thème
Cette section répertorie les emplacements des récipients qui accueillent cette donnée.
| ID Inclusion | Balisage |
|---|---|
all-head-content |
Original |
openGraphMetaData |
Original |
main |
Contempo
Essential
Notable
Soho
|
postCommentsAndAd |
Emporio |
snippetedPostByline |
Original |
<head> |
Contempo
Emporio
Essential
Notable
Soho
|
<body> |
Contempo
Emporio
Essential
Notable
Soho
|
Les dictionnaires de données
Licence - La reproduction du contenu de ce blog n'est pas autorisée
Aucune disposition des Conditions d'Utilisation de ce blog ne pourra être interprétée comme conférant à l'Utilisateur une licence sur les Droits de Propriété Intellectuelle.
Le blog Blogger Code PE ne concède qu'une autorisation de visualisation de son contenu à titre personnel et privé. Les copies ou reproductions doivent être strictement réservées à l'usage privé du copiste.
Toute reproduction abusive, totale ou partielle du blog Blogger Code PE, représentation, modification, publication, traduction, adaptation totale ou partielle de l'un quelconque de ces éléments, accompagnée ou non d'un lien de référence, quel que soit le moyen ou le procédé utilisé, est interdite et sera considérée comme constitutive d’une contrefaçon et passible de poursuite (Les peines prévues à cet effet sont une condamnation de 3 ans d'emprisonnement et une amende de 300.000€) conformément aux dispositions des articles L.335-2 et suivants du Code de Propriété Intellectuelle.
Affiliée au 
Google Product Experts Program - Ambassador & Troubleshooter.
- Affectation Google France, produit Blogger, du 11/07/2011 au 28/07/2014.
- Affectation Google US, produit Blogger depuis le 28/07/2014.
Spécialisation : Technologie des thèmes Blogger.
Auteur originel de la théorie du langage XML Blogger : Règles syntaxiques, directives d'usage, classifications, compilations et corrélations des composants.
Cela représente près de 10 années de travail. Je remercie tous ceux qui ont respecté ma propriété intellectuelle et j'offre mes meilleurs sentiments aux nombreux contributeurs (Amis, Utilisateurs, Experts Produits Google, Blogger Team et Ingénieurs).
