ThéorieRéférences XMLTypes des données

Les tableaux [array]

Les données booléennes [boolean]
Le terme array est employé pour qualifier une structure de données.

Les types de tableaux

Un tableau est une structure de données dont tous les éléments doivent être du même type.
Ainsi, nous pouvons disposer des tableaux d'objets, de chaînes de caractères, etc...

Type Contenu Bibliothèque Blogger
array[object] Un tableau d'objets. Chaque objet peut contenir 1 ou plusieurs items. Disponible
array[string] Un tableau de chaînes de caractères. Ce tableau ne peut contenir que des données de type string. Disponible
array[number] Un tableau de nombres. Ce tableau ne peut contenir que des données de type number. inexistant
array[boolean] Un tableau de booléens. Ce tableau ne peut contenir que des données de type boolean. inexistant
array[URL] Un tableau d'URLs. Ce tableau ne peut contenir que des données de type URL. inexistant
array[image] Un tableau d'URLs d'images. Ce tableau ne peut contenir que des données de type image. inexistant


Écrire de nouveaux tableaux

Bien que certains types de tableaux n'existent pas dans la bibliothèque de données, des tableaux array[string], array[number] et array[boolean], peuvent être écrit explicitement dans une expression Blogger.

Tableau de chaînes de caractères
<b:with value='["string1","string2","string3"]' var='myArrayString'>
  
</b:with>

Tableau de nombres
<b:with value='[200,400,800,1600]' var='myArrayNumber'>
  
</b:with>

Tableau de booléens
<b:with value='[true,false,true,true]' var='myArrayBoolean'>
  
</b:with>


Les opérateurs

Certains opérateurs permettent de traiter des tableaux.
Consultez les opérateurs au cas par cas pour connaître ceux qui requièrent des tableaux entrants et ceux qui renvoient un nouveau tableau.

Les opérateurs recommandés :

Remarque : Un tableau vide ou rempli, renvoie toujours une réponse "vraie". Pour vérifier la véracité d'un tableau, utilisez la longueur du tableau (voir chapitre suivant).


Paramètres additionnels

Les données de type array disposent de paramètres additionnels qui permettent d'obtenir des informations supplémentaires sur le tableau.

Paramètre Type de la valeur Signification
length number Renvoie le nombre de sets contenus dans le tableau.
Remarque : Ces paramètres sont également disponible pour les données de type string et renvoie le nombre de caractères contenus dans la chaîne.
size


D'un point de vue technique, ces paramètres sont des données contenues dans un objet et qui renvoient une nouvelle valeur :


Représentation des ressources
"data": {
  "dataArray": [array],
               { 
                 "length": number,
                 "size": number
               }
}


En pratique, ces paramètres s'ajoutent simplement au nom de la donnée et renvoie une nouvelle valeur.
Quelques exemples avec la donnée du widget Blog, data:posts :


Le tableau
data:posts

Longueur du tableau
data:posts.length

Longueur du tableau
data:posts.size


L'indice d'un tableau

L'indice d'un tableau est une donnée numérique pouvant être obtenue à l'aide de l'attribut index dans une balise b:loop.

<b:loop index='index' values='data:posts' var='itemNumber'>

  <data:index/>

</b:loop>

Le comptage de l'index commence toujours à partir du numéro 0.
Pour que le comptage démarre à partir de 1, il suffit d'écrire une nouvelle expression mathématique.

<b:loop index='index' values='data:posts' var='itemNumber'>

  <b:eval expr='data:index + 1'/>

</b:loop>


Extraire les items d'un tableau avec b:loop

La balise b:loop a été conçue pour traiter les tableaux.
Il suffit d'ajouter le nom du tableau dans l'attribut values et d'écrire les balises de sorties de chaque donnée dans les nœuds enfants.

Exemple array[object]
<b:loop values='data:posts' var='p'>

  <data:p.title/>
  <data:p.date/>
  <data:p.body/>

</b:loop>
data:posts est un tableau d'objets contenants plusieurs items : Dans cet exemple, le titre, la date et le corps de l'article.

Exemple array[string|number|boolean|URL|image]
<b:loop value='data:truc' var='machin'>

  <data:machin/>

</b:with>
Pour les besoins de l'exemple, data:truc est un tableau fictif dont le contenu est soit string, number, boolean, URL ou image.


Extraire un item de tableau par son indice

Un item de tableau peut être extrait à l'aide de son indice sans avoir recours à la balise b:loop.

syntaxe
data:array[index]

Le numéro d'index peut être un nombre ou une variable.
Pour afficher explicitement la valeur de l'item, la balise d'évaluation est requise.
Attention : Un indice inexistant empêche le widget de travailler ou renvoie un message d'erreur sur le blog si l'expression se trouve en-dehors d'un gadget. L'éditeur XML ne vous informe pas de ce type d'erreur.
Pour éviter les erreurs, vous pouvez utiliser la longueur du tableau que vous injectez dans une opération mathématique. L'indice dans le nom de la donnée sera une variable.

Exemple array[object]
<b:with value='data:posts.length - 1' var='lastPost'>

  <b:eval expr='data:posts[lastPost].title'/>

</b:with>
data:posts est un tableau d'objets.
La première expression calcule l'indice du dernier élément de ce tableau.
La variable reporte le résultat de l'opération mathématique dans une donnée. Dans cet exemple, le titre du dernier article (title)

Exemple array[string|number|boolean|URL|image]
<b:with value='data:truc.length - 1' var='lastItem'>

  <b:eval expr='data:truc[lastItem]'/>

</b:with>
Pour les besoins de l'exemple, data:truc est un tableau fictif dont le contenu est soit string, number, boolean, URL ou image.
La première expression calcule l'indice du dernier élément du tableau.
La variable reporte le résultat de l'opération mathématique dans la donnée qui affichera la valeur du dernier item.
Dernière modification :
Assistance publique pour le produit Blogger sur les Forums d'aides :

Certifiée par Google - Experte TC :
  • Affectation Google France, produit Blogger, du 11/07/2011 au 28/07/2014.
  • Affectation Google US, produit Blogger depuis le 28/07/2014.

Posts les plus consultés de ce blog

ThéorieRéférences XMLParamètres des données
Le paramètre Image redimensionnable [isResizable]
Populaire
DéveloppementsFichiers XML
Populaire