data:{ Image } - Blogger Data Documentation
- Description de l'ensemble
Imageest le type d'un gadget officiel Blogger qui affiche sur votre blog une image en provenance du web ou de votre ordinateur.
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 Image.
- 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.
Ressources
Échantillonnage principal et les réglages
widget:
type: Image,
version: 1 | 2
,
this: object,
/* NO SETTINGS */
Échantillonnage des items de l'objet - Gadget Version 1
widget:
type: Image,
version: 1
,
this:
title: string,
sourceUrl: string,
link: string,
width: number,
height: number,
sectionWidth: number,
caption: string,
shrinkToFit: boolean
Échantillonnage des items de l'objet - Gadget Version 2
widget:
type: Image,
version: 2
,
this:
title: string,
sourceUrl: string,
link: string,
width: number,
height: number,
sectionWidth: number,
caption: string,
shrinkToFit: boolean,
sourceSet: string
Parenté - Enfant de :
- Image
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 Image, il existe un set universel qui n'est disponible que dans les thèmes version 3 :
