Variable d'habillage de longueur / Length skin variable
Le terme length(skin) est employé pour qualifier une variable d'habillage Blogger.
Une variable de type length(skin) contient une longueur, généralement en px ou en em.
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="length" min="value" max="value" default="value" value="value" hideEditor="true or false" />
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 |
min |
Valeur minimum que peut accepter une variable de type length(skin). | facultatif |
max |
Valeur maximum que peut accepter une variable de type length(skin). | facultatif |
default |
La valeur par défaut de la variable. Le nombre doit être compris entre les valeurs définies dans les attributs min et max. |
obligatoire |
value |
La valeur courante de la variable. Le nombre doit être compris entre les valeurs définies dans les attributs min et max. |
obligatoire |
hideEditor |
Cet attribut permet de masquer ou de forcer l'affichage du formulaire dans l'outil de conception. Valeur : |
facultatif |
<Variable name="column.length"
description="Column Length"
type="length"
min="0"
max="1000px"
default="360px"
value="360px"
hideEditor="false" />
La valeur
La valeur des attributs min, max, default et value doit contenir un nombre dont l'unité de mesure peut être en px ou em. L'unité de mesure n'est pas requise si la valeur est égale à zéro.
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)
Pour construire l'alias, 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 $.
<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.
Opérations arithmétiques
Une variable de type length(skin) convertie au format b:skin peut subir des opérations arithmétiques avec les opérateurs +, -, * et /
$(variable.name + 5px)
$(variable.name - 5px)
$(variable.name * 2)
$(variable.name / 2)
Le formulaire dans le concepteur
Lorsqu'une variable de type length(skin) est définie dans le thème, un formulaire s'ajoute dans l'outil de conception de thèmes :
- UI
- Thème
- Personnaliser
- Avancé
Note : Pour que le formulaire soit disponible dans les Layouts versions 1 et 2, la variable doit être imbriquée dans une balise <Group>.
