Variable d'habillage d'URL / URL skin variable

Le terme url(skin) est employé pour qualifier une variable d'habillage Blogger.
Une variable de type url(skin) contient l'adresse d'une image qui sert généralement à définir un arrière-plan.

Attention !!! La valeur d'une variable de type url(skin) n'est pas une donnée de type url.

Syntaxes

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.

Syntaxe de la variable

<Variable name="name"
          description="description"
          type="url"
          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 . (point) peut être utilisé. 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

Exemple

<Variable name="background.url"
          description="Image Background"
          type="url"
          default="url(https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgziAYuMlGzitTb2J1Njpq12HdfJ_gYmXarucsC9B-2WrJbjZbduCpMK-uWzPmY-fi2kBG5jUBLJFni5VwRsgKAzCh9ntvV2pZHeCSqIkM7F5oGVPvgDM7ON7LIUV7E32MjPM5zZ2GAaL9A/s1600/BCodeBanYT.jpg)"
          value="url(https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgziAYuMlGzitTb2J1Njpq12HdfJ_gYmXarucsC9B-2WrJbjZbduCpMK-uWzPmY-fi2kBG5jUBLJFni5VwRsgKAzCh9ntvV2pZHeCSqIkM7F5oGVPvgDM7ON7LIUV7E32MjPM5zZ2GAaL9A/s1600/BCodeBanYT.jpg)" />

La valeur

La valeur des attributs default et value doit contenir une url destinée à un paramètre css d'arrière-plan. Autrement dit, l'url doit être une image.

Exemple 1

https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgziAYuMlGzitTb2J1Njpq12HdfJ_gYmXarucsC9B-2WrJbjZbduCpMK-uWzPmY-fi2kBG5jUBLJFni5VwRsgKAzCh9ntvV2pZHeCSqIkM7F5oGVPvgDM7ON7LIUV7E32MjPM5zZ2GAaL9A/s1600/BCodeBanYT.jpg

Exemple 2

url(https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgziAYuMlGzitTb2J1Njpq12HdfJ_gYmXarucsC9B-2WrJbjZbduCpMK-uWzPmY-fi2kBG5jUBLJFni5VwRsgKAzCh9ntvV2pZHeCSqIkM7F5oGVPvgDM7ON7LIUV7E32MjPM5zZ2GAaL9A/s1600/BCodeBanYT.jpg)

Pour les 2 cas, la valeur de sortie sera

url(https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgziAYuMlGzitTb2J1Njpq12HdfJ_gYmXarucsC9B-2WrJbjZbduCpMK-uWzPmY-fi2kBG5jUBLJFni5VwRsgKAzCh9ntvV2pZHeCSqIkM7F5oGVPvgDM7ON7LIUV7E32MjPM5zZ2GAaL9A/s1600/BCodeBanYT.jpg)

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.

Conversion au format b:skin

$(variable.name)

Pour construire le récipient, il faut reprendre le nom de la variable, l'encadrer de parenthèses (obligatoire, si le nom contient un point) et ajouter le préfixe $.

Conversion au format XML

<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 URL, elle n'est pas reconnue comme étant de type url et ne bénéficie pas des mêmes spécificités comme par exemple les paramètres additionnels (https, http, canonical).

Les autres types de données

• array
• automatic (skin)
• background (skin)
• boolean
• color (skin)
• date
• font (skin)
• image
• length (skin)
• locale
• message
• number
• object
• string
• string (skin)
• url
• url (skin)

Retourner à l'introduction