data:{ PopularPosts } - Blogger Data Documentation
| Data Type | Gadget Version 1 | Gadget Version 2 |
|---|---|---|
| object | PopularPosts | PopularPosts |
- Description de l'ensemble
PopularPostsest le nom d'un gadget officiel Blogger qui affiche les articles les plus consultés de votre blog.
Cette page et les pages annexes énumèrent notre sélection des données Blogger disponibles dans le modèle de gadget par défaut.- Intégration de l'ensemble dans le code XML
- Dans les nœuds enfants du gadget PopularPosts.
- Statut du gadget
- Lecture/écriture.
- Directives d'usage et niveau de priorité de mise à jour
-
Thème Version 1Garantie d'usage : OuiPriorité faibleThème Version 2Garantie d'usage : OuiPriorité moyenneThème DynamiqueGarantie d'usage : AucuneAucune prioritéThème Version 3Garantie d'usage : OuiPriorité haute
- Set de réglages XML
- Inexistant.
- Condition additionnelle
- Aucune.
Table des matières
- Ressources
- Échantillonnage principal et les réglages
- Échantillonnage des items de l'objet - Gadget Version 1
- Échantillonnage des sous-ensembles - Gadget Version 1
- Échantillonnage des items de l'objet - Gadget Version 2
- Échantillonnage des sous-ensembles - Gadget Version 2
- Implémentation des items de l'objet
- Méthode de Référence Directe
- Méthode d’Aliasing de l’Item
- Méthode d’Aliasing de l’Instance du Gadget
- Les données universelles
Ressources
Échantillonnage principal et les réglages
widget:
type: PopularPosts,
version: 1 | 2
,
this: object,
/* NO SETTINGS */
Échantillonnage des items de l'objet - Gadget Version 1
widget:
type: PopularPosts,
version: 1
,
this:
title: string,
posts: array,
showThumbnails: boolean,
showSnippets: boolean,
thumbnailSize: number
Échantillonnage des sous-ensembles - Gadget Version 1
widget:
type: PopularPosts,
version: 1
,
this:
posts: array
Échantillonnage des items de l'objet - Gadget Version 2
widget:
type: PopularPosts,
version: 2
,
this:
title: string,
posts: array,
postDisplay: object
Échantillonnage des sous-ensembles - Gadget Version 2
widget:
type: PopularPosts,
version: 2
,
this:
postDisplay: object,
posts:
snippets: object,
labels: array,
author:
authorPhoto: object
Parenté - Enfant de :
- PopularPosts
this
Note : La racine du dictionnaire de données de ce gadget est un objet sans nom. Par souci de clarté et de conformité avec les règles syntaxiques, nous le nommons this. Dans les thèmes officiels, l’ingénierie Blogger utilise principalement top dans la version 1 et this dans la version 2. L'utilisation d'un alias n'est pas obligatoire, mais elle permet notamment de simplifier la réutilisation des inclusions partageant les mêmes jeux de données, même si les items ne sont pas situés dans le même nœud ou dictionnaire.
Implémentation des items de l'objet
Méthode de Référence Directe
<b:includable id='main'>
<!-- Tag -->
<data:ITEM_NAME/>
<!-- Attribute value -->
<b:eval expr='data:ITEM_NAME'/>
</b:includable>
La Direct Reference Method est la méthode la plus simple et la plus directe pour accéder à une donnée. Elle consiste à insérer la donnée telle quelle dans le code XML, sans alias ni encapsulation. Cette approche est adaptée aux données primitives du schéma de données, celles qui peuvent être appelées directement sans transformation ni boucle.
Méthode d’Aliasing de l’Item
<b:includable id='main'>
<b:with value='data:ITEM_NAME' var='ITEM_NAME'>
<!-- Tag -->
<data:ITEM_NAME/>
<!-- Attribute value -->
<b:eval expr='data:ITEM_NAME'/>
</b:with>
</b:includable>
L’Alias Item Method permet de stocker un item unique dans une variable temporaire à l’aide de <b:with>. Cette approche améliore la lisibilité du code et réduit la redondance lorsque la même valeur est utilisée plusieurs fois.
Méthode d’Aliasing de l’Instance du Gadget
<b:includable id='main' var='this'>
<!-- Tag -->
<data:this.ITEM_NAME/>
<!-- Attribute value -->
<b:eval expr='data:this.ITEM_NAME'/>
</b:includable>
La Gadget Instance Aliasing Method consiste à stocker l’instance du gadget en cours dans une variable temporaire définie dans la balise principale <b:includable>, afin de faciliter l’accès à ses données. Elle permet également de réutiliser les inclusions enfants (ou inclusions communes) qui partagent des jeux de données similaires, même lorsque les items ne sont pas situés dans le même dictionnaire.
Les données universelles
En plus des données traditionnelles spécifiques au gadget PopularPosts, il existe un set universel qui n'est disponible que dans les thèmes version 3 :
Échantillonnage des ressources
widgets:
PopularPosts:
title: string,
type: string,
sectionId: string,
id: string,
posts:
id: number,
title: string
Implémentation
<b:loop values='data:widgets.PopularPosts' var='PopularPosts'>
<data:PopularPosts.title/>
<data:PopularPosts.type/>
<data:PopularPosts.sectionId/>
<data:PopularPosts.id/>
<b:loop values='data:PopularPosts.posts' var='post'>
<data:post.id/>
<data:post.title/>
</b:loop>
</b:loop>
