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

Les types de données

• array
• boolean
• date
• image
• locale
• message
• number
• object
• string
• url

• automatic (skin)
• background (skin)
• color (skin)
• font (skin)
• length (skin)
• string (skin)
• url (skin)

Introduction aux types de données