data:data - Blogger Data Documentation

Data Type Gadget Version 1 Gadget Version 2
array[Object] BlogArchive BlogArchive
Blogger - Gadget BlogArchive - data:data / data:data[i].data / data:data[i].data[i].data
  • 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

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

Parenté - Enfant de :

  • 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

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

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


Spotlight

Populaires cette semaine