Variable d'habillage de longueur / Length skin variable

Blogger - Length skin type

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 . (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
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 : true ou false
facultatif
Exemple
<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.
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.

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 /
Exemple - Une addition
$(variable.name + 5px)
Exemple - Une soustraction
$(variable.name - 5px)
Exemple - Une multiplication
$(variable.name * 2)
Exemple - Une division
$(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>.


Blogger Humour - Monsieur Smiley achète des pixels à l'usine de PX.


Spotlight

Populaires cette semaine