Variable d'habillage de chaîne de caractères / String skin variable
Le terme string(skin) est employé pour qualifier une variable d'habillage Blogger. Une variable de type string(skin) contient une chaîne de caractères. Cette variable est généralement utilisée en dernier recours lorsque la valeur que l'on souhaite ajouter ne correspond à aucun type existant.
Syntaxe
Les variables d'habillage sont définies dans l'éditeur XML du thème, entre les balises <b:skin></b:skin>
. Elles permettent de reporter une valeur dans la section des CSS ou/et dans le reste du thème XML.
<Variable name="name" description="description" type="string" default="value" value="value" />
Attributs
Paramètre | Signification | - |
---|---|---|
name |
Le nom ne peut contenir que des lettres ou des chiffres et doit être unique. Exception : Le caractère Ce nom sera utilisé pour extraire la valeur de la variable. |
obligatoire |
description |
Une courte description. |
obligatoire |
type |
Détermine le type de la valeur de la variable. | obligatoire |
default |
La valeur par défaut de la variable. | obligatoire |
value |
La valeur courante de la variable. | obligatoire |
<Variable name="short.text" description="Short Text" type="string" default="Un court texte" value="Un court texte" />
La valeur
La valeur des attributs default
et value
doit contenir une simple chaîne de caractères.
Un court texte
Sortie des données
Lorsque la variable est définie, il est possible de la convertir au format b:skin
pour l'employer dans les CSS, ou au format XML pour extraire la valeur à l'extérieur des CSS.
$(variable.name)
$
.
<data:skin.vars.variable_name/>
Pour convertir au format XML, il faut mentionner l'objet data:skin.vars
, suivi du nom de la variable.
Si la variable contient un point, il doit être remplacer par un tiret bas _
.
Lorsque la donnée est convertie, elle devient de type skin et peut être injectée dans des expressions.
Attention !!! Même si la valeur convertie est une chaîne de caractères, elle n'est pas reconnue comme étant de type string et ne bénéficie pas des mêmes spécificités comme par exemple les paramètres additionnels (échappements
, longueur
, etc).