Base de connaissancesRéférences XMLTypes des données

Les nombres [number]

Les données booléennes [boolean]
Le terme number est employé pour qualifier le type d'une valeur.
Une valeur de type number est... un nombre.

Dans les expressions Blogger

Plusieurs données de la bibliothèque Blogger renvoient une valeur de type number.
Ces données sont souvent des dimensions de containers ou de photos, parfois des longueurs de tableaux.
Vous trouverez la liste complète dans la bibliothèque [filtre number].

Contrairement à une simple chaîne de caractères, un nombre qui est écrit explicitement dans une expression Blogger, n'est jamais encadré par des quotes. Si la valeur est encadrée par des quotes, celle-ci sera considérée comme étant de type string.
  • La valeur 24 est de type number
  • La valeur "24" est de type string


Les opérateurs

Les données/valeurs de type number peuvent être injectées dans la majorité des opérations.
Consultez les opérateurs au cas par cas pour connaître ceux qui acceptent les données number entrantes et ceux qui renvoient un résultat de type number.


Longueur d'une chaine de caractères

La longueur d'une chaîne est une caractéristique spécifique aux données de type string. En ajoutant le suffixe length à ce type de donnée, vous obtiendrez le nombre de caractères contenus dans cette donnée.

Exemple
<data:blog.metaDescription/>
<data:blog.metaDescription.length/>
La donnée data:blog.metaDescription est de type string.
En lui ajoutant le suffixe .length, le type de la nouvelle donnée sera number.


Longueur d'un tableau

Même scénario que pour la longueur d'une chaîne, la longueur d'un tableau est une caractéristique spécifique aux données de type array. En ajoutant le suffixe length à ce type de donnée, vous obtiendrez le nombre de sets contenus dans ce tableau.

<data:posts.length/>
La donnée data:posts est de type array.
En lui ajoutant le suffixe .length, le type de la nouvelle donnée sera number.


Dimensions d'une image

En appliquant les suffixes width et height aux données de type image, vous obtiendrez respectivement la largeur et la hauteur originale de l'image. Bien évidement, ces valeurs sont des nombres et peuvent être utilisés comme tels dans les opérations.
Toutefois, attention ! Ces valeurs ne sont disponibles que si ces informations sont mentionnées explicitement dans les metas de l'image.

La largeur
<data:view.featuredImage.width/>

La hauteur
<data:view.featuredImage.height/>


Nombres et dates

Il existe un arsenal de suffixes permettant d'extraire les jours, mois et années des données de type date. En appliquant les suffixes year, month, day, dayOfWeek, dayOfMonth et dayOfYear, ces valeurs deviennent des nombres et peuvent être utilisés comme tels dans les opérations.
Attention ! Les suffixes destinés aux dates est une exclusivité "Gadget V2".


Année
<b:loop values='data:posts' var='post'>
  <data:post.date.year/>
</b:loop>

Mois
<b:loop values='data:posts' var='post'>
  <data:post.date.month/>
</b:loop>

Jour
<b:loop values='data:posts' var='post'>
  <data:post.date.day/>
</b:loop>

Jour de la semaine
<b:loop values='data:posts' var='post'>
  <data:post.date.dayOfWeek/>
</b:loop>

Jour du mois
<b:loop values='data:posts' var='post'>
  <data:post.date.dayOfMonth/>
</b:loop>

Jour de l'année
<b:loop values='data:posts' var='post'>
  <data:post.date.dayOfYear/>
</b:loop>


L'indice d'un item d'un tableau

L'indice d'un item d'un tableau est une valeur 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'indice 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>


array[number]

array[number] est un type de tableau contenant que des valeurs number.

array[200,400,800,1600]

Il n'existe aucun tableau de ce type dans la bibliothèque des données Blogger, mais si une telle donnée existait, il faudrait employer la balise b:loop

Exemple fictif
<b:loop values='data:arrayNumber' var='itemNumber'>

  <data:itemNumber/>

</b:loop>

Pourquoi avoir mentionné le type array[number] dans cette documentation si aucune donnée de ce type ne figure dans la bibliothèque ?
Il est vrai que la bibliothèque ne contient pas de données de ce type, mais il est possible d'en créer. Pour cela, vous devez utiliser une donnée de type array[object] avec l'opérateur lambda map qui se chargera de regrouper une donnée de type number contenue dans l'objet du tableau.

Syntaxe
array[object] map (var => var.number)

Exemple
<b:loop values='data:posts map (x => x.numComments)' var='postNumComments'>

  Comments : <data:postNumComments/>

</b:loop>
Dans la balise de la boucle, l'opérateur map transforme le tableau objet data:posts en un tableau de type array[number].
La donnée data:postNumComments (dont le contenu est transféré à l'aide de la variable définie dans la boucle), affichera le nombre de commentaires de chaque post.

A savoir : Des tableaux array[number], ainsi que des tableaux array[string] et array[boolean], peuvent être écrit explicitement dans une expression Blogger.

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

Des sets de nombres sont souvent utiles pour redimensionner des images, définir des ratios, dessiner des graphiques ou encore créer des statistiques.
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 connaissancesFonctionnalitésContenu
Populaire
DéveloppementsMulti-versions
Facebook : Bouton J'aime [Like button]
Populaire
DéveloppementsMulti-versions
Twitter : Bouton Suivre [Follow button]
Populaire