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].data et data:data[i].data[i].data sont 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.

• Disponibilité par défaut par type de pages :

  Toutes les pages.

• Longueur maximum des ensembles :

  data : Demandez à Nostradamus.

  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

• Principal + Réglages
• Items
• Détails des items

É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.

• data
• expclass
• name
• post-count
• posts
• toggleId
• url

Parenté - Enfant de :

• 12
• this
• data

• 12
• this
• data
• data

• 12
• this
• data
• data
• data

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).

Style	Ensembles	Mensuelle	Hebdomadaire	Quotidienne
Hiérarchie	this	✔ ALL	✔ ALL	✔ ALL
	this.data	✔ YEAR	✔ YEAR	✔ YEAR
	this.data[i].data	✔ MONTH	✔ WEEK	✔ MONTH
	this.data[i].data[i].data	✘	✘	✔ DAY
Liste condensée Menu déroulant	this	✔ ALL	✔ ALL	✔ ALL
	this.data	✔ MONTH	✔ WEEK	✔ DAY
	this.data[i].data	✘	✘	✘
	this.data[i].data[i].data	✘	✘	✘

Implantation des ensembles

• Syntaxe basique
• Syntaxe d'uniformisation
• Indice
• Sens inverse

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/Dernier
• Longueur
• Est vide ?

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.

Premier et dernier set d'un tableau

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.

Longueur d'un tableau

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.

Le tableau est vide ?

Récipients dans le thème

Cette section répertorie les emplacements des récipients qui accueillent cette donnée.

Data	Gadget Type	ID Inclusion	Gadget Version	Layouts Version	Thème
data	BlogArchive	flat	1	1 2	Default
data	BlogArchive	flat	2	3	Default
data	BlogArchive	flat	2	3	Essential Contempo Emporio Notable Soho
data	BlogArchive	hierarchy	2	3	Essential Contempo Emporio Notable Soho
data data[i].data data[i].data[i].data	BlogArchive	interval	1	1 2	Default
data data[i].data data[i].data[i].data	BlogArchive	interval	2	3	Default
data	BlogArchive	menu	1	1 2	Default

Données dans le même ensemble

• data
• expclass
• name
• post-count
• posts
• style
• title
• toggleId
• toggleopen
• url