Base de connaissancesRé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 contient uniquement des données de type string. Disponible
array[number] Un tableau de nombres. Ce tableau contient uniquement des données de type number. -
array[boolean] Un tableau de booléens. Ce tableau contient uniquement des données de type boolean. -
array[image] Un tableau d'images. Ce tableau contient uniquement des données de type image. -
array[URL] Un tableau d'URLs. Ce tableau contient uniquement des données de type URL. -
array[date] Un tableau de dates. Ce tableau contient uniquement des données de type date. -


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


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
empty boolean Vérifie si le tableau est vide.
notEmpty boolean Vérifie si le tableau n'est pas vide.
any
first array
object
string
boolean
number
image
URL
date
Extrait le premier set du tableau.
last Extrait le dernier set du tableau.


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


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
ou
data:posts.size

Ce tableau est vide
data:posts.empty

Ce tableau n'est pas vide
data:posts.notEmpty
ou
data:posts.any

Filtre: Premier set
data:posts.first

Filtre: Dernier set
data:posts.last


Conversion automatique

Lorsqu'un tableau a été filtré (par exemple avec un opérateur Lambda) et que le résultat ne renvoie plus qu'un seul set, le tableau devient le type de ce set.

  • array[object] devient object
  • array[string] devient string
  • array[boolean] devient boolean
  • array[number] devient number
  • array[image] devient image
  • array[URL] devient URL
  • array[date] devient date


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 à l'aide d'une boucle

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]
<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 ou boolean.


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]
<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 ou boolean.
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.
Assistance publique pour le produit Blogger sur les supports  d'aides :

Certifiée par Google - Experte Platine TC (Ambassador & Advanced Troubleshooter):
  • 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

Base de connaissancesFiches techniquesInclusions universelles
Balises de l'entête HTML des thèmes [all-head-content]
Populaire
DéveloppementsFichiers XML
Pack Plugins Facebook [like/share/send/save/quote]
Populaire
DéveloppementsMulti-versions
Facebook : Bouton J'aime [Like button]
Populaire
Base de connaissancesFonctionnalitésContenu
Populaire
Base de connaissancesFonctionnalitésÉditeurs
Populaire