Variables d'habillage - Les URLs [url]

Le terme url est employé pour qualifier une variable d'habillage.
Une variable de type url contient une adresse web.

Syntaxes

Les variables d'habillage sont définies dans l'éditeur XML du modèle, entre les balises <b:skin></b:skin>. Elles permettent de reporter une valeur dans la section des CSS ou/et dans le reste du modèle XML.

Syntaxe de la variable

<Variable name="name"
          description="description"
          type="url"
          default="value"
          value="value" />

Syntaxe de la valeur

url(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

Sortie des données

Lorsque la variable est définie, il est possible d'en extraire sa valeur dans la section réservée aux CSS ou/et à l'extérieur de la balise b:skin.

Dans la balise b:skin, il suffit de reprendre le nom de la variable, de l'encadrer de parenthèses et d'ajouter le préfixe $.

Par exemple, la variable dont le nom est background.url, sa syntaxe de sortie sera $(background.url).
A savoir : Les parenthèses ne sont requises que si le nom de la variable contient un point.

Définition de la variable

<Variable name="background.url"
          description="Image Background"
          type="url"
          default="url(https://lh5.googleusercontent.com/-usDU2zLhtDA/UjwV61KL07I/AAAAAAAAA-0/GT3UL09LA_c/s1600/BCodeBanYT.jpg)"
          value="url(https://lh5.googleusercontent.com/-usDU2zLhtDA/UjwV61KL07I/AAAAAAAAA-0/GT3UL09LA_c/s1600/BCodeBanYT.jpg)" />

Intégration de la variable dans les CSS

header {
  background-image: $(background.url);
}

Rendu HTML

header {
  background-image: url(https://lh5.googleusercontent.com/-usDU2zLhtDA/UjwV61KL07I/AAAAAAAAA-0/GT3UL09LA_c/s1600/BCodeBanYT.jpg);
}

Lorsque l'on souhaite exporter la valeur à l'extérieur de b:skin, le langage XML reprend ses droits et la donnée peut être traitée comme les autres données issues d'un dictionnaire quelconque.
La donnée convertie, devient de type string et peut être injectée dans des expressions.

background.url devient : data:skin.vars.background_url.
Si le nom de la variable contient un point, celui-ci devient un tiret bas _.

Balise de sortie data

<data:skin.vars.background_url/>

Complément : Bibliothèque des variables "url" définies dans les modèles officiels.

Participer à la conversation

Dernière modification : dimanche, 25 septembre 2016