Introduction : Les réglages des données / Data settings

Les réglages des données (ou paramètres additionnels des données) sont des suffixes s'ajoutant aux données XML des thèmes Blogger et qui permettent d'obtenir des informations supplémentaires ou d'appliquer une caractéristique à la valeur.

Fonctionnement

D'un point de vue technique, les réglages sont considérés comme des données qui sont contenues dans un objet, qui lui-même est contenu dans la donnée à régler. Chaque réglage renvoit une nouvelle valeur.

Exemple de représentation des ressources

  item: original_value,
        
          setting: new_value,
          setting: new_value,
          setting: new_value,
          setting: new_value,
          etc...
        

En pratique, dans l'éditeur XML du thème, ce réglage s'ajoute simplement au nom de la donnée :

<data:item.setting/>

Ou aussi, à la suite d'une opération qui est encadrée de parenthèses :

<b:eval expr='(data:item snippet { length: 68 }).setting/>

Les réglages des données sont disponibles par type de valeurs. Par exemple, un réglage destiné uniquement à une chaîne de caractères string ne peut pas être appliqué à une valeur booléenne boolean.
Avant d'appliquer l'un de ces réglages à une donnée, il est important de connaître son type officiel.

Explorateur des données Blogger Introduction aux types des données Blogger

Dés que vous connaissez son type, vous vous référez aux schémas des ressources ci-dessous.

ATTENTION !!!

Contrairement à Json et à d'autres formats similaires, les dictionnaires des données XML de Blogger, y compris les réglages, sont renfermés dans un fichier inaccessible au public. De part cette confidentialité, les listes que vous trouvez sur le web (ici ou ailleurs) sont les résultats d'un travail laborieux de quelqu'un et sont automatiquement protégées par les règlements de la DMCA.

Ces listes sont considèrées comme des reconstitutions et des appréciations personnelles de son auteur et elles font parties de sa propriété intellectuelle. En aucun cas, ces listes sont la propriété de Blogger et encore moins, libre de droit. En les republiant sans l'autorisation de l'auteur originel, vous devenez hors-la-loi !

Réglages des données « string »

Ces réglages s'appliquent aux données et valeurs de types string, url, image, date, locale et message.

Échantillonnage des ressources

  size: number,
  length: number,
  escaped: string,
  jsEscaped: string,
  jsonEscaped: string,
  cssEscaped: string

Réglages	Description	Sortie
Longueur d'une chaine
length size	Renvoient la longueur de la chaîne de caractères.	Sortie : number
Échappement de la chaîne
escaped	Renvoie l'équivalent HTML échappé de la chaîne de caractères.	Sortie : string
jsEscaped	Renvoie l'équivalent JS échappé de la chaîne de caractères.	Sortie : string
jsonEscaped	Renvoie l'équivalent JSON échappé de la chaîne de caractères.	Sortie : string
cssEscaped	Renvoie l'équivalent CSS échappé de la chaîne de caractères.	Sortie : string

Réglages des données « url »

Ces réglages s'appliquent aux données et valeurs de types url.

Échantillonnage des ressources

  canonical: URL,
  http: URL,
  https: URL

Réglages	Description	Sortie
URL canonique
canonical	Renvoie l'url canonique de l'url courante.	Sortie : URL
HyperText Transfer Protocol Secure
http	Renvoie l'url avec le protocole http.	Sortie : URL
https	Renvoie l'url avec le protocole https.	Sortie : URL

Réglages des données « image »

Ces réglages s'appliquent aux données et valeurs de types image.

Échantillonnage des ressources

  isResizable: boolean,
  isYoutube: boolean,
  youtubeMaxResDefaultUrl: image,
  width: number,
  height: number,
  originalWidth: number,
  originalHeight: number

Réglages	Description	Sortie
Image redimensionnable
isResizable	Indique si l'image peut être redimensionnée avec les opérateurs d'images.	Sortie : boolean
Image YouTube
isYoutube	Indique si l'image provient de YouTube.	Sortie : boolean
youtubeMaxResDefaultUrl	Fourni l'URL de la vignette maxresdefault.jpg des vidéos YouTube.	Sortie : image
Dimensions de l'image
width	Renvoie la largeur de l'image (Si mentionnée explicitement).	Sortie : number
height	Renvoie la hauteur de l'image (Si mentionnée explicitement).	Sortie : number
originalWidth	Renvoie la largeur originale de l'image (Si mentionnée explicitement).	Sortie : number
originalHeight	Renvoie la hauteur originale de l'image (Si mentionnée explicitement).	Sortie : number

Réglages des données « date »

Ces réglages s'appliquent aux données et valeurs de types date.

Échantillonnage des ressources

  iso8601: string,
  year: number,
  month: number,
  day: number,
  dayOfWeek: number,
  dayOfMonth: number,
  dayOfYear: number

Réglages	Description	Sortie
Format ISO 8601
iso8601	Renvoie la date au format ISO 8601.	Sortie : string
Numéro du jour / mois / année
day dayOfMonth	Renvoient le jour du mois.	Sortie : number
month	Renvoie le mois (1 pour janvier, 2 pour février, etc).	Sortie : number
year	Renvoie l'année (4 chiffres).	Sortie : number
dayOfWeek	Renvoie le jour de la semaine (1 pour lundi, 2 pour mardi, etc).	Sortie : number
dayOfYear	Renvoie le jour de l'année (1 pour le 1er janvier, 2 pour le 2 janvier, 32 pour le 1er février, etc).	Sortie : number

Réglages des données « locale »

Ces réglages s'appliquent aux données et valeurs de types locale.

Échantillonnage des ressources

  name: string,
  language: string,
  country: string,
  variant: string,
  languageDirection: string,
  languageAlignment: string

Réglages	Description	Sortie
Paramètres de localisation
name	Renvoie le nom de la langue courante. English pour l'anglais, French pour le français, etc.	Sortie : string
language	Renvoie l’abréviation de la langue courante. en pour l'anglais, fr pour le français, etc.	Sortie : string
country	Renvoie l’abréviation de la langue et du pays associé. fr-FR pour la France, fr-CA pour le Canada, fr-BE pour la Belgique, fr-CH pour la Suisse, etc.	Sortie : string
variant	Renvoie la variante de la langue courante. fr-BE-wa pour le wallon en Belgique, etc.	Sortie : string
Sens de lecture et alignement
languageDirection	Indique le sens de lecture de la langue courante. ltr de gauche à droite ou rtl de droite à gauche. Ce réglage est l'équivalent de la donnée blog.languageDirection .	Sortie : string
languageAlignment	Indique l'alignement du contenu associé à la langue courante. left à partir de la gauche ou right à partir de la droite. Ce réglage est l'équivalent de la donnée skin.vars.startSide.	Sortie : string

Réglages des tableaux

Ces réglages s'appliquent aux array.

(inclus: array[object], array[string], array[boolean], array[number], array[URL], array[image] et array[date]).

Échantillonnage des ressources

  size: number,
  length: number,
  empty: boolean,
  notEmpty: boolean,
  any: boolean,
  first:  Child type of the array ,
  last:  Child type of the array 

Réglages	Description	Sortie
Longueur du tableau
length size	Renvoient le nombre de sets contenus dans un tableau.	Sortie : number
Premier et dernier set
first	Sélectionne le premier set d'un tableau. array[object] devient object, array[string] devient string, etc...	Sortie : Type enfant du tableau.
last	Sélectionne le dernier set d'un tableau. array[object] devient object, array[string] devient string, etc...	Sortie : Type enfant du tableau.
Filtres spéciaux
widgetType	Filtre par widget. Ce réglage sélectionne les sets d'un tableau d'un même type de gadget et s'applique uniquement au tableau widgets .	Sortie : array[object]
itemName	Filtre par option. Ce réglage sélectionne le set d'un tableau correspondant au nom de l'item : widgets[i].headerByline.items widgets[i].footerBylines[i].items widgets[i].allBylineItems	Sortie : object
Tableau vide
empty	Indique si le tableau est vide.	Sortie : boolean
notEmpty any	Indique si le tableau n'est pas vide.	Sortie : boolean

Réglages des tableaux d'images redimensionnées

Ces réglages sont des exceptions, parce qu'ils ne s'appliquent pas à un type de données spécifique, mais uniquement aux items issus d'une opération qui crée un tableau d'images redimensionnées array[image].

Échantillonnage des ressources

  url: image,
  size: number

Réglages	Description	Sortie
size	La taille de l'image.	Sortie : number
url	URL de l'image redimensionnée.	Sortie : image

Réglages des données « skin »

Ces paramètres s'appliquent uniquement aux données définies dans les variables d'habillage.

Introduction aux variables d'habillage

Réglages	Description	Sortie (Data Type)	Sortie (Skin Type)
Paramètres Arrière-plan background(skin)
image	Renvoie l'url de l'image d'arrière-plan.	Sortie (Data) : image	Sortie (Skin) : indisponible
color	Renvoie le code de couleur associé à l'arrière-plan.	Sortie (Data) : color(skin)	Sortie (Skin) : color(skin)
Paramètres de polices font(skin)
size	Renvoie la taille de la police.	Sortie (Data) : string	Sortie (Skin) : length(skin)
family	Renvoie le nom de la police.	Sortie (Data) : string	Sortie (Skin) : string(skin)
Paramètres des couleurs color(skin)
transparent	Converti le code de couleur en un code de couleur RGBA transparent.	Sortie (Data) : string	Sortie (Skin) : string(skin)
inverse	Converti le code de couleur en un code de couleur RGBA inversé.	Sortie (Data) : string	Sortie (Skin) : string(skin)
red	Renvoie le code RGB de couleur rouge. Nombre compris entre 0 et 255.	Sortie (Data) : string	Sortie (Skin) : string(skin)
green	Renvoie le code RGB de couleur verte. Nombre compris entre 0 et 255.	Sortie (Data) : string	Sortie (Skin) : string(skin)
blue	Renvoie le code RGB de couleur bleue. Nombre compris entre 0 et 255.	Sortie (Data) : string	Sortie (Skin) : string(skin)
alpha	Renvoie le niveau de transparence du code de couleur RGBA. Nombre compris entre 0.0 et 1.0.	Sortie (Data) : string	Sortie (Skin) : string(skin)

Les autres références XML

• Les balises
• Les attributs des balises
• Les types de données
• Les réglages des données
• Les opérateurs

Retourner dans la Base de Connaissances