data:blog.sharing.platforms - Blogger Data Documentation
| Data Type | Gadget Version 1 | Gadget Version 2 |
|---|---|---|
| array[Object] | Global | Global |
- Description de l'ensemble
data:blog.sharing.platformsest un tableau universel Blogger qui contient des sets de données permettant de créer des boutons de partage.- Intégration dans le code XML
- Dans les nœuds enfants de la balise
<html>, excepté à l'intérieur des marqueurs<![CDATA[ ]]>. - Directives d'usage et niveau de priorité de mise à jour
-
Thème Version 1Garantie d'usage : AbandonnéPriorité indéfinieThème Version 2Garantie d'usage : ExpérimentalPriorité indéfinieThème DynamiqueGarantie d'usage : ExpérimentalPriorité indéfinieThème Version 3Garantie d'usage : OuiPriorité haute
- Disponibilité par défaut par type de pages
- Toutes les pages.
- Longueur maximum de l'ensemble
- 6 applications : Lien, Facebook, BlogThis!, Twitter, Pinterest et E-mail.
- Set de réglages XML
- Disponible.
- Condition additionnelle
- Aucune.
Ressources
Échantillonnage principal et les réglages du tableau
blog:
sharing:
platforms: array,
size: number,
length: number,
empty: boolean,
notEmpty: boolean,
any: boolean,
first: object,
last: object
Échantillonnage des items du tableau
blog:
sharing:
platforms:
name: string,
key: string,
shareMessage: string,
target: string
Implantation du tableau
Syntaxe basique
<b:loop values='data:blog.sharing.platforms' var='platform'> <!-- Tag --> <data:platform.ITEM_NAME/> <!-- Attribute value --> <b:eval expr='data:platform.ITEM_NAME'/> </b:loop>
Syntaxe d'uniformisation
<b:with value='data:blog' var='this'> <b:with value='data:this.sharing' var='sharing'> <b:loop values='data:sharing.platforms' var='platform'> <!-- Tag --> <data:platform.ITEM_NAME/> <!-- Attribute value --> <b:eval expr='data:platform.ITEM_NAME'/> </b:loop> </b:with> </b:with>
La syntaxe d'uniformisation est une méthode qui consiste à inclure l'item dans un objet afin d'obtenir la formule object.item. Cette méthode permet de faciliter la réutilisation d'inclusions contenant les mêmes jeux de données, même si les items ne sont pas dans le même nœud ou dans le même dictionnaire.
Indice de l'item
<b:loop values='data:blog.sharing.platforms' var='platform' index='i'> <!-- Index (number) --> <data:i/> <!-- Index [i] --> <b:eval expr='data:blog.sharing.platforms[i].ITEM_NAME'/> <!-- Index [i+1] --> <b:with value='data:i + 1' var='next'> <b:eval expr='data:blog.sharing.platforms[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:blog.sharing.platforms[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:blog.sharing.platforms' var='platform' reverse='true'> <data:platform.ITEM_NAME/> </b:loop> <!-- REVERSE CONDITION --> <b:loop values='data:blog.sharing.platforms' var='platform' expr:reverse='data:view.isPost'> <data:platform.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 :
Premier et dernier item du tableau
<!-- FIRST --> <b:eval expr='data:blog.sharing.platforms.first.ITEM_NAME'/> <!-- LAST --> <b:eval expr='data:blog.sharing.platforms.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.
Longueur du tableau
<!-- WITH SIZE --> <data:blog.sharing.platforms.size/> <!-- WITH LENGTH --> <data:blog.sharing.platforms.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.
Ce tableau est vide ?
<!-- EMPTY --> <b:if cond='data:blog.sharing.platforms.empty'></b:if> <!-- NOT EMPTY --> <b:if cond='data:blog.sharing.platforms.notEmpty'></b:if> <!-- ANY --> <b:if cond='data:blog.sharing.platforms.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.
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:blog.sharing.platforms.length - (data:blog.sharing.platforms.length % 2)) / 2' var='half'> <!-- TAKE (FIRST HALF) --> <b:loop values='data:blog.sharing.platforms take data:half' var='platform'> <b:eval expr='data:platform.ITEM_NAME'/> </b:loop> <!-- SKIP (SECOND HALF) --> <b:loop values='data:blog.sharing.platforms skip data:half + 1' var='platform'> <b:eval expr='data:platform.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:blog.sharing.platforms.any'> <!-- CHRONOLOGICAL --> <b:loop values='0 to data:blog.sharing.platforms.size - 1' var='number'> <b:eval expr='data:blog.sharing.platforms[number].ITEM_NAME'/> </b:loop> <!-- REVERSE --> <b:loop values='data:blog.sharing.platforms.size - 1 to 0' var='number'> <b:eval expr='data:blog.sharing.platforms[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:blog.sharing.platforms all (platform => platform.ITEM_NAME)'></b:if> <!-- COUNT --> <b:eval expr='data:blog.sharing.platforms count (platform => platform.ITEM_NAME)'/> <!-- FILTER --> <b:loop values='data:blog.sharing.platforms where (platform => platform.ITEM_NAME)' var='platform'> <b:eval expr='data:platform.ITEM_NAME'/> </b:loop> <!-- MAPPING --> <b:loop values='data:blog.sharing.platforms map (platform => platform.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 complexe.
Récipients dans le thème
Cette section répertorie les emplacements des récipients qui accueillent cette donnée.
| ID Inclusion | Balisage |
|---|---|
post |
Soho |
postShareButtons |
Original |
sharingButtonsMenu |
Original |
Données dans le même ensemble
data:blog.sharing...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).
