Variables d'habillage - Les polices [font]

Les polices [font]
Le terme font est employé pour qualifier une variable d'habillage.
Une variable de type font contient les paramètres d'une police.

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="font"
          family="value"
          size="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
family La valeur attendue doit être le nom de la police. facultatif
size La valeur attendue doit être la taille de la police. facultatif
default La valeur par défaut de la variable. obligatoire
value La valeur courante de la variable. obligatoire
hideEditor Cet attribut permet de masquer le formulaire dans l'outil de conception.
Valeur : true ou false
facultatif
Exemple
<Variable name="text.font"
          description="Text Font"
          type="font"
          default="italic bold 12px Georgia, Utopia, 'Palatino Linotype', Palatino, serif"
          value="italic bold 12px Georgia, Utopia, 'Palatino Linotype', Palatino, serif" />


La valeur

La valeur des attributs default et value doit contenir les paramètres standards CSS de la police.
Syntaxe de la valeur
font-style font-weight font-size font-family
Exemple
italic bold 12px Georgia, Utopia, 'Palatino Linotype', Palatino, serif

Les attributs size et family sont facultatifs. Ils permettent d'intégrer ces valeurs séparément dans les attributs default et value via les noms réservés $(size) et $(family).
Exemple
<Variable name="text.font"
          description="Text Font"
          type="font"
          size="12px"
          family="Georgia, Utopia, 'Palatino Linotype', Palatino, serif"
          default="italic bold $(size) $(family)"
          value="italic bold $(size) $(family)" />


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.


Paramètres additionnels

Les variables de type font contiennent un objet d'items qui permettent d'extraire la taille et le nom de la police.
Ressources
variable type font: {
  "size": skin(length),
  "family": skin(string)
}

Pour pouvoir utiliser ces paramètres, il suffit d'ajouter ces items au nom de la donnée.
En savoir plus


Le formulaire dans le concepteur

Lorsqu'une variable de type font est définie dans le thème, un formulaire est automatiquement affiché dans l'outil de conception de thèmes:

  • Tableau de bord
  • Thème
  • Personnaliser
  • Avancé




Polices Blogger

Cette section a été déplacée dans l'Appendice.
Consultez l'Appendice

Posts les plus consultés de ce blog

Ajouter des boutons à la barre de partage Blogger