Data ExplorerListe des donnéesGadgets

data:posts[i].labels

Description Statut Data Type Gadget Gadget Version
Donnée du gadget Blog. Tableau labels, imbriqué dans le tableau posts.
courant
array[Object]
Blog
1
2

Ressources

"data": {
  "widget": {
    "type": "Blog",
    "version": 1 | 2
  },
  "posts": [{
    "labels": [ array ],
      {
        "size": number,
        "length": number,
        "empty": boolean,
        "notEmpty": boolean,
        "any": boolean,
        "first": { object },
        "last": { object }
      }
  }]
}

Conditions

  • Ne peut être employée que dans le code XML du gadget Blog.
  • Tableau imbriqué dans le tableau posts.
  • Disponible uniquement sur les pages archive, index et item.

Valeur

  • Tableau[Objet] - Array[Object]
  • Tableau contenant les libellés de l'article

Items de l'objet (Gadget V1)
[{
  "name": string,
  "url": URL,
  "isLast": boolean
}]

Items de l'objet (Gadget V2)
[{
  "name": string,
  "url": URL
}]

Extraction explicite

La donnée affichera un tableau avec des valeurs "null", puisque ce tableau contient plusieurs items.

Méthode 1 : Dans une boucle
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS'>
  <data:VARIABLE_NAME_POSTS.labels/>
</b:loop>

Méthode 2 : Par l'indice
<b:eval expr='data:posts[0].labels'/>

Extraction explicite des items du tableau

Le tableau des libellés étant imbriqué dans le tableau des articles, cela entraine une multiplication du nombre de combinaisons.
Pour simplifier cette démo, le tableau des articles (data:posts) a été inclus dans une boucle <b:loop/>.
Il est également possible d'extraire les items du tableau des libellés (data:posts[i].labels) sans utiliser une boucle <b:loop/> avec le tableau data:posts.

Méthode 1 : Dans une boucle
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:loop values='data:VARIABLE_NAME_POSTS.labels' var='VARIABLE_NAME_LABELS' >

    <!-- Les données du tableau "labels" doivent être ajoutées à l'intérieur de cette boucle -->
    <data:VARIABLE_NAME_LABELS.DATA_LABELS_NAME/>

  </b:loop>

</b:loop>

Méthode 2 : Par l'indice
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:eval expr='data:VARIABLE_NAME_POSTS.labels[0].DATA_NAME_LABELS'/>

</b:loop>

Premier et dernier set du tableau

Les suffixes .first (premier set) et .last (dernier set) transforment le tableau en un objet ne contenant que le premier ou le dernier set du tableau.
Ce qui permet d'extraire les items de ces sets, sans avoir à utiliser une boucle.

Un item du premier set
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <data:VARIABLE_NAME_POSTS.labels.first.DATA_NAME/>

</b:loop>

Un item du dernier set
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <data:VARIABLE_NAME_POSTS.labels.last.DATA_NAME/>

</b:loop>

Longueur du tableau

Les suffixes size et length permettent de connaître le nombre de set dans ce tableau. Le résultat sera une valeur numérique.

Avec le suffixe Size
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <data:VARIABLE_NAME_POSTS.labels.size/>

</b:loop>

Avec le suffixe length
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <data:VARIABLE_NAME_POSTS.labels.length/>

</b:loop>

Ce tableau n'est pas vide ?

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.

Est vide
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:if cond='data:VARIABLE_NAME_POSTS.labels.empty'>

  </b:if>

</b:loop>

N'est pas vide (avec le suffixe notEmpty)
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:if cond='data:VARIABLE_NAME_POSTS.labels.notEmpty'>

  </b:if>

</b:loop>

N'est pas vide (avec le suffixe any)
<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:if cond='data:VARIABLE_NAME_POSTS.labels.any'>

  </b:if>

</b:loop>

L'indice des items du tableau

L'indice des items est une valeur numérique (number). Il ne peut être obtenu qu'à l'intérieur d'une boucle <b:loop/>.

<b:loop values='data:posts' var='VARIABLE_NAME_POSTS' >

  <b:loop index='INDEX_NAME_LABELS' values='data:VARIABLE_NAME_POSTS.labels' var='VARIABLE_NAME_LABELS'>

  <!-- L'indice est obtenu à l'intérieur de la boucle -->
    <data:INDEX_NAME_LABELS/>

  </b:loop>

</b:loop>
Dernière modification :

Posts les plus consultés de ce blog

DéveloppementsFichiers XML
Favicons multi-sets [icon / apple-touch-icon / msapplication]
Populaire
ThéorieRéférences XMLTypes des variables d'habillage
Variables d'habillage - Les arrière-plans [background]
Populaire
ThéorieRéférences XMLParamètres des données
Les paramètres caractères d'échappement [escaped/jsEscaped/jsonEscaped/cssEscaped]
Populaire
DéveloppementsFichiers XML
Résumés des articles avec images réactives [Pack 2016]
Populaire