data:{ HTML/Text } - Blogger Data Documentation
- Description de l'ensemble
HTMLetTextsont des types de gadgets officiels Blogger qui permettent d'ajouter une fonctionnalité tierce, un code ou encore un simple texte à 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 des gadgets HTML et Text.
- 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
widget:
type: HTML|Text,
version: 1 | 2
,
this: object,
/* NO SETTINGS */
Échantillonnage des items de l'objet
widget:
type: HTML|Text,
version: 1 | 2
,
this:
title: string,
content: string
Parenté - Enfant de :
- HTML Text
this
Note : La racine du dictionnaire de données de ces deux gadgets est un objet sans nom. Par souci de clarté et de conformité avec les règles syntaxiques, nous les 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 aux gadgets HTML et Text, il existe un ensemble universel qui n'est disponible que dans les thèmes version 3 :
Échantillonnage des ressources
widgets:
HTML or Text:
title: string,
type: string,
sectionId: string,
id: string
Implémentation
<b:loop values='data:widgets.HTML' var='HTML'>
<data:HTML.title/>
<data:HTML.type/>
<data:HTML.sectionId/>
<data:HTML.id/>
</b:loop>
<b:loop values='data:widgets.Text' var='Text'>
<data:Text.title/>
<data:Text.type/>
<data:Text.sectionId/>
<data:Text.id/>
</b:loop>
