data:data
Blogger Data Documentation
| Data Type | Gadget Version 1 | Gadget Version 2 | 
|---|---|---|
| array[Object] | BlogArchive | BlogArchive | 
- Description des ensembles
 data:data,data:data[i].dataetdata:data[i].data[i].datasont des tableaux de données Blogger du gadget « Archives du blog » contenant les items en relation avec la période d'archivage des articles du blog.- Intégration dans le code XML
 - Dans les nœuds enfants du gadget BlogArchive.
 - 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
 - Disponibilité par défaut par type de pages
 - Toutes les pages.
 - Longueur maximum des ensembles
 data: Illimité.data[i].data: 12 mois ou 52 semaines.data[i].data[i].data: 31 jours.- Set de réglages XML
 - Disponible.
 - Conditions additionnelles
 data: Aucune.data[i].data: L'affichage hiérarchique est requis.data[i].data[i].data: L'affichage hiérarchique quotidien est requis.
Ressources
Échantillonnage principal et les réglages des tableaux
  widget: 
    type: BlogArchive,
    version: 1 | 2
  ,
  this: 
    data:
      
        size: number,
        length: number,
        empty: boolean,
        notEmpty: boolean,
        any: boolean,
        first: object,
        last: object
      ,
      
      data:
        
          size: number,
          length: number,
          empty: boolean,
          notEmpty: boolean,
          any: boolean,
          first: object,
          last: object
        ,
        
        data:
          
            size: number,
            length: number,
            empty: boolean,
            notEmpty: boolean,
            any: boolean,
            first: object,
            last: object
          ,
          
      
    
  
Échantillonnage des items des ensembles
  widget: 
    type: BlogArchive,
    version: 1 | 2
  ,
  this: 
    data: 
      name: string,
      url: URL,
      post-count: number,
      expclass: string,
      toggleId: string,
      data: 
        name: string,
        url: URL,
        post-count: number,
        expclass: string,
        toggleId: string,
        posts: array,
        data: 
          name: string,
          url: URL,
          post-count: number,
          expclass: string,
          toggleId: string,
          posts: array
        
      
    
  
Parcourez nos fiches pour afficher les détails de chaque item.
Disponibilité des ensembles
Les ensembles sont disponibles en fonction des réglages définis dans le panneau de configuration du gadget.
Dans le tableau ci-dessous, nous avons inclu l'ensemble racine this qui contient également les items identiques pour la période globale (non-utilisé dans le thème par défaut et non-raccordé à l'UI).
| Ensembles | Mensuelle | Hebdomadaire | Quotidienne | 
|---|---|---|---|
| Style Hiérarchie | |||
this | 
        ALL | 
        ALL | 
        ALL | 
      
this.data | 
        YEAR | 
        YEAR | 
        YEAR | 
      
this.data[i].data | 
        MONTH | 
        WEEK | 
        MONTH | 
      
this.data[i].data[i].data | 
        Non | Non | DAY | 
      
| Liste condensée / Menu déroulant | |||
this | 
        ALL | 
        ALL | 
        ALL | 
      
this.data | 
        MONTH | 
        WEEK | 
        DAY | 
      
this.data[i].data | 
        Non | Non | Non | 
this.data[i].data[i].data | 
        Non | Non | Non | 
Implémentation des ensembles
Syntaxe basique
<b:includable id='main'> <!-- LEVEL 1 --> <b:loop values='data:data' var='level1'> <data:level1.ITEM_NAME/> <!-- LEVEL 2 --> <b:loop values='data:level1.data' var='level2'> <data:level2.ITEM_NAME/> <!-- LEVEL 3 --> <b:loop values='data:level2.data' var='level3'> <data:level3.ITEM_NAME/> </b:loop> </b:loop> </b:loop> </b:includable>
Dans cet exemple, nous avons choisi les noms de variable level1, level2 et level3 afin de bien distinguer les tableaux imbriqués.
Syntaxe d'uniformisation
<b:includable id='main' var='this'> <b:loop values='data:this' var='period'> <!-- OUTPUT ALL LEVELS --> <data:period.ITEM_NAME/> <!-- CALL NEXT LEVEL --> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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 d'inclure les données équivalentes de tous les autres ensembles du gadget dans une même inclusion.
Dans cet exemple, nous avons choisi les noms de variable this pour les tableaux imbriqués et period pour les items des tableaux. Sous cette configuration, le niveau racine est également inclu.
Dans tous les exemples suivants, nous utilisons cette syntaxe.
Indice de l'item
<b:includable id='main' var='this'> <b:loop values='data:this' var='period' index='i'> <!-- Index [i] --> <b:eval expr='data:this[i].ITEM_NAME'/> <!-- Index [i+1] --> <b:with value='data:i + 1' var='next'> <b:eval expr='data:this[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:this[prev].ITEM_NAME'/> </b:with> </b:if> <!-- CALL NEXT LEVEL --> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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 les données de cette manière : data:array[index].item. Quant aux données, elles doivent obligatoirement être intégrée 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
<b:includable id='main' var='this'> <b:loop values='data:this' var='period' reverse='true'> <!-- OUTPUT ALL LEVELS --> <data:period.ITEM_NAME/> <!-- CALL NEXT LEVEL --> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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).
Les réglages des ensembles
Les réglages sont des items contenus dans l'objet des tableaux qui renvoient une nouvelle valeur. Dans la syntaxe, ils s'ajoutent à la suite du nom des tableaux.
Introduction aux réglages des données
Les réglages autorisés pour ces tableaux (excepté l'ensemble racine) sont :
Premier et dernier item de chaque tableau
<b:includable id='main' var='this'> <!-- First --> <b:eval expr='data:this.first.ITEM_NAME'/> <!-- Last --> <b:eval expr='data:this.last.ITEM_NAME'/> <!-- CALL NEXT LEVEL --> <b:loop values='data:this' var='period'> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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 de chaque tableau
<b:includable id='main' var='this'> <!-- WITH SIZE --> <data:this.size/> <!-- WITH LENGTH --> <data:this.length/> <!-- CALL NEXT LEVEL --> <b:loop values='data:this' var='period'> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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 ?
<b:includable id='main' var='this'> <!-- EMPTY --> <b:if cond='data:this.empty'></b:if> <!-- NOT EMPTY --> <b:if cond='data:this.notEmpty'></b:if> <!-- ANY --> <b:if cond='data:this.any'></b:if> <!-- CALL NEXT LEVEL --> <b:loop values='data:this' var='period'> <b:include cond='data:period.data' data='period.data' name='main'/> </b:loop> </b:includable>
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.
Alias dans le modèle
Cette section permet d'identifier les emplacements dans le fichier XML où la donnée est implémentée sous différents alias. L’alias peut être identique à la clé d’origine ou être une adaptation spécifique à une ou plusieurs inclusions.
Dans le tableau ci-dessous, nous ne mentionnons que les assignations directes sans manipulation de la valeur, à l'exception des réglages appliqués par suffixe.
| Alias | Clés | ID Inclusion | Balisage | 
|---|---|---|---|
data | 
        data | 
        flat | 
        Default  | 
      
data | 
        data | 
        flat | 
        Default  | 
      
this.data | 
        data | 
        flat | 
        
           Essential 
          Contempo 
          Emporio 
          Notable 
          Soho 
         | 
      
this.data | 
        data | 
        hierarchy | 
        
           Essential 
          Contempo 
          Emporio 
          Notable 
          Soho 
         | 
      
          
  | 
        
          
  | 
        interval | 
        Default  | 
      
          
  | 
        
          
  | 
        interval | 
        Default  | 
      
data | 
        data | 
        menu | 
        Default  |