Data ExplorerListe des donnéesGadgets

data:items

Description Statut Data Type Gadget Gadget Version
Donnée du gadget TextList. Tableau contenant les données items.
courant
array[String]
TextList
1
2

Ressources

"data": {
  "widget": {
    "type": "TextList",
    "version": 1 | 2
  },
  "items": [ 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 TextList.
  • Disponible sur toutes les pages.

Valeur

  • Tableau de chaînes de caractères - Array[string]
  • Liste des items


Créer un tableau d'items dans le gadget Liste


Extraction explicite du tableau

La donnée affichera un tableau avec les valeurs contenues dans le set, puisque ce tableau ne contient qu'un seul set.

<b:eval expr='data:items'/>

Extraction explicite des items du tableau

Contrairement aux tableaux objet, les items d'un tableau composés de chaînes de caractères, sont extrait uniquement à l'aide d'un nom de variable.

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

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

</b:loop>

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

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
<data:items.first/>

Un item du dernier set
<data:items.last/>

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
<data:items.size/>

Avec le suffixe length
<data:items.length/>

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:if cond='data:items.empty'>

</b:if>

N'est pas vide (avec le suffixe notEmpty)
<b:if cond='data:items.notEmpty'>

</b:if>

N'est pas vide (avec le suffixe any)
<b:if cond='data:items.any'>

</b:if>

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 index='INDEX_NAME' values='data:items' var='VARIABLE_NAME' >

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

</b:loop>

Posts les plus consultés de ce blog

ThéorieFonctionnalitésContenu
Populaire
DéveloppementsMulti-versions
Populaire
ThéorieFonctionnalitésGestion
Populaire
DéveloppementsFichiers XML
Populaire
ThéorieFiches techniquesInclusions universelles
Balises de l'entête HTML des thèmes [all-head-content]
Populaire