data:widgets[i].posts

Data TypeGadget TypeDefault Gadget VersionLayouts Version
array[Object]
Global
2
3

Ressources

"data": {
  "widgets": [{
    "posts": [ array ],
      {
        "size": number,
        "length": number,
        "empty": boolean,
        "notEmpty": boolean,
        "any": boolean,
        "first": Child type of the array,
        "last": Child type of the array
      }
  }]
}


Caractéristiques

  • Peut être employée dans l'ensemble du code XML du thème.
  • Layouts Version 3 et Gadget Version 2.
  • Disponible sur toutes les pages.
  • Les gadgets doivent être visibles.
  • Disponible uniquement dans les sets correspondants aux gadgets Blog et PopularPosts.


Valeur

  • Tableau[Objet] array[Object].
  • Tableau composé d'une liste d'articles contenus dans les gadgets Blog et PopularPosts

Items de l'objet - Gadget Blog
[{
  "id": string,
  "title": string,
  "featuredImage": image,
  "showInlineAds": boolean
}]
Items de l'objet - Gadget PopularPosts
[{
  "id": string,
  "title": string
}]


Extraction explicite des items du tableau

Le tableau étant emboîté dans plusieurs tableaux, le choix de la méthode d'extraction dépendra du résultat que vous voulez obtenir.
Pour réduire le temps de réponse, limitez le nombre de boucles et privilégiez l'usage de filtres :
Filtres par type de gadget Filtres premier et dernier set d'un tableau
Gadget Blog
<b:loop values='data:widgets.Blog' var='widget'>

  <b:loop values='data:widget.posts' var='post'>

    <!-- ADD ITEMS HERE -->
    <data:post.ITEM_NAME/>

  </b:loop>

</b:loop>
Gadget PopularPosts
<b:loop values='data:widgets.PopularPosts' var='widget'>

  <b:loop values='data:widget.posts' var='post'>

    <!-- ADD ITEMS HERE -->
    <data:post.ITEM_NAME/>

  </b:loop>

</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.
En savoir plus
Premier et dernier set - Gadget Blog
<b:loop values='data:widgets.Blog' var='widget'>

  <!-- FIRST SET -->
  <data:widget.posts.first.ITEM_NAME/>

  <!-- LAST SET -->
  <data:widget.posts.last.ITEM_NAME/>

</b:loop>
Premier et dernier set - Gadget PopularPosts
<b:loop values='data:widgets.PopularPosts' var='widget'>

  <!-- FIRST SET -->
  <data:widget.posts.first.ITEM_NAME/>

  <!-- LAST SET -->
  <data:widget.posts.last.ITEM_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.
En savoir plus
Nombre de posts - Gadget Blog
<b:loop values='data:widgets.Blog' var='widget'>

  <!-- WITH SIZE -->
  <data:widget.posts.size/>

  <!-- WITH LENGTH -->
  <data:widget.posts.length/>

</b:loop>
Nombre de posts - Gadget PopularPosts
<b:loop values='data:widgets.PopularPosts' var='widget'>

  <!-- WITH SIZE -->
  <data:widget.posts.size/>

  <!-- WITH LENGTH -->
  <data:widget.posts.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.
En savoir plus
Gadget Blog
<b:loop values='data:widgets.Blog' var='widget'>

  <!-- EMPTY -->
  <b:if cond='data:widget.posts.empty'></b:if>

  <!-- NOT EMPTY -->
  <b:if cond='data:widget.posts.notEmpty'></b:if>

</b:loop>
Gadget PopularPosts
<b:loop values='data:widgets.PopularPosts' var='widget'>

  <!-- EMPTY -->
  <b:if cond='data:widget.posts.empty'></b:if>

  <!-- NOT EMPTY -->
  <b:if cond='data:widget.posts.notEmpty'></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/>.
Gadget Blog
<b:loop index='index' values='data:widgets.Blog.first.posts' var='post'>

  <!-- ADD INDEX HERE -->
  <data:index/>

</b:loop>
Gadget PopularPosts
<b:loop values='data:widgets.PopularPosts' var='widget'>

  <b:loop index='index' values='data:widget.posts' var='post'>

    <!-- ADD INDEX HERE -->
    <data:index/>

  </b:loop>

</b:loop>


Implantation de la donnée dans le modèle par défaut

Gadget Type Inclusion Gadget Version Thème
Common
Common
openGraphMetaData 1 2


Autres tableaux d'articles

Gadget Type Data Gadget Version Layouts Version Data Type
Blog
Blog
data:posts 1 2 1 2 3 array[Object]
FeaturedPost
data:posts 2 3 array[Object]
PopularPosts
data:posts 1 2 1 2 3 array[Object]
BlogArchive
data:data[i].data[i].posts 1 2 1 2 3 array[Object]
BlogArchive
data:data[i].data[i].data[i].posts 1 2 1 2 3 array[Object]

Posts les plus consultés de ce blog