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

Les chaînes de caractères [string]

Les chaînes de caractères [string]
Le terme string est employé pour qualifier le type d'une valeur.
Une valeur de type string est une chaîne de caractères.

Dans les expressions Blogger

Une grande quantité de données renvoient une valeur de type string.
Vous trouverez la liste complète dans la bibliothèque [filtre string].

Dans une expression Blogger, une donnée de type string est toujours considérée true (vraie), lorsque son contenu n'est pas vide.

Une chaîne de caractères écrite explicitement dans une expression Blogger, doit toujours être encadrée par des quotes :
  • "value"
  • "value"


Les opérateurs

Les données/valeurs de type string 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 string entrantes et ceux qui renvoient un résultat de type string.

Paramètres additionnels

Les données de type string disposent de paramètres additionnels qui permettent d'obtenir des informations supplémentaires ou d'appliquer une caractéristique à la chaîne de caractères.

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


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": {
  "dataString": string,
                { 
                  "length": number,
                  "size": number,
                  "escaped": string
                }
}


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 globale data:blog.title :


Titre du blog
data:blog.title

Longueur de la chaîne
data:blog.title.length

Longueur de la chaîne
data:blog.title.size

Chaîne de caractères échappés
data:blog.title.escaped


Cas particuliers - string vs number/boolean

Parfois, une valeur string ou le contenu d'une donnée string peut engendrer quelques confusions dans une opération. En particulier lorsqu'il s'agit de nombres et de booléens.
  • Cas 1 : Si le contenu de la donnée de type string est un nombre ou un booléen, la valeur sera automatiquement considérée comme une valeur de type number ou boolean.
  • Cas 2 : Si le contenu de la donnée de type string contient les valeurs booléennes yes ou no, ces valeurs seront automatiquement remplacées respectivement par les valeurs true ou false. Dans ce cas, elles seront considérées comme des valeurs booléennes.
  • Cas 3 : Si la valeur est un nombre ou un booléen encadré de quotes, la valeur sera considérée comme une valeur de type string.
  • Cas 4 : Si la valeur est un nombre ou un booléen encadré de quotes et que cette valeur est reportée dans une variable var, le contenu de la variable sera considéré comme une valeur de type number ou boolean.
Cas 1
<b:if cond='data:truc'>

</b:if>
La donnée data:truc est une donnée de type string.
Si la valeur est "true", le type de la donnée devient boolean dont la valeur sera true.
Il en est de même si la valeur est "17", le type de la donnée devient number dont la valeur sera 17.

Cas 2
<b:if cond='data:truc'>

</b:if>
La donnée data:truc est une donnée de type string.
Si la valeur est "yes", le type de la donnée devient boolean dont la valeur sera true.
Il en est de même si la valeur est "no", le type de la donnée devient boolean dont la valeur sera false.

Cas 3
<b:if cond='data:truc == "true" and data:machin == "17"'>

</b:if>
La chaîne de caractères "true" est de type string.
La chaîne de caractères "17" est de type string.
Ces valeurs seront toujours de type string.

Cas 4
<b:with value='"true"' var='truc'>
<b:with value='"17"' var='machin'>

  <b:eval expr='data:truc + ", my number is " + data:machin'/>

</b:with>
</b:with>
Les chaînes de caractères "true" et "17" sont de type string.
Ces valeurs sont reportées respectivement par les variables truc et machin dans les données data:truc et data:machin, qui deviennent boolean et number.
La valeur de data:truc sera true et la valeur de data:machin sera 17.


array[string]

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

array["string1","string2","string3","string4"]

Dans toute la collection des données Blogger, seul le widget textList dispose d'une donnée de ce type : data:items.
Voir la représentation des ressources du widget TextList.

Pour extraire les données string de ce tableau, il faut employer la balise b:loop.

Exemple
<b:loop values='data:items' var='itemString'>

  <data:itemString/>

</b:loop>

Pour obtenir d'autres données de ce type, 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 string contenue dans l'objet du tableau.
Consultez la liste des tableaux[objet] disponibles dans la bibliothèque.

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

Exemple
<b:with value='data:posts map (x => x.title)' var='newArrayString'>

  <b:loop values='data:newArrayString' var='postTitle'>

    <data:postTitle/>

  </b:loop>

</b:with>
L'opérateur map compile les valeurs de la donnée title contenue dans le tableau objet data:posts. Le nouveau tableau de chaînes de caractères est créé et stocké dans la variable newArrayString.
Dans le nœud enfant, la nouvelle donnée de type array[string] est traitée dans une boucle b:loop.
La donnée data:postTitle (dont le contenu est transféré à l'aide de la variable définie dans la boucle), affichera les titres de chaque post.

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

<b:with value='["string1","string2","string3"]' var='myArrayString'>
  
</b:with>

<b:if cond='data:blog.pageType in ["string1","string2","string3"]'>
  
</b:if>
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