Base de connaissancesRé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"

Exemple 1
<b:with value='"Mon message est string"' var='maChaine'>
  <data:maChaine/>
</b:with>

Exemple 2
<b:with value='data:messages.share + "cet article"' var='maChaine'>
  <data:maChaine/>
</b:with>


Héritage String

Certains types de données s'emploient également avec des quotes. C'est le cas des données de type "image", "url", "date", "locale" et "message".
Ces données ont leur propres caractéristiques, mais travaillent comme une donnée de type "string". Par conséquent, elles héritent des mêmes fonctionnalités.


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 Échappement HTML d'une chaîne de caractères.
jsEscaped string Échappement JS d'une chaîne de caractères.
jsonEscaped string Échappement JSON d'une chaîne de caractères.
cssEscaped string Échappement CSS 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


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 universelle 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

Échappement HTML
data:blog.title.escaped

Échappement JS
data:blog.title.jsEscaped

Échappement JSON
data:blog.title.jsonEscaped

Échappement CSS
data:blog.title.cssEscaped


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:loop values='data:posts map (x => x.title)' var='postTitle'>

  <data:postTitle/>

</b:loop>
L'opérateur map compile les valeurs de la donnée title contenue dans le tableau objet data:posts.
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:loop values='["string1","string2","string3"]' var='myArrayString'>
  
</b:loop>

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

DéveloppementsFichiers XML
Populaire
DéveloppementsMulti-versions
Facebook : Bouton partager [Share button]
Populaire
Base de connaissancesFiches techniquesInclusions universelles
Balises de l'entête HTML des thèmes [all-head-content]
Populaire
Base de connaissancesFonctionnalitésÉditeurs
Populaire
Base de connaissancesFonctionnalitésThèmes
Populaire