Les paramètres additionnels des données [introduction]

Nous vous rappelons que lorsque vous accédez à ce blog, vous signez automatiquement un accord avec Blogger Code.
Consultez les CGU.


Blogger - Data parameters - Paramètres des données
Les paramètres additionnels des données sont des suffixes s'ajoutant aux données Blogger et qui permettent d'obtenir des informations supplémentaires ou d'appliquer une caractéristique à la valeur.


Fonctionnement

Les paramètres des données travaillent par type de valeurs. Par exemple, un paramètre 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 paramètres à une donnée, il est important de connaître sa classification officielle.
Bibliothèque des données En pratique, ce paramètre s'ajoute simplement au nom de la donnée et renvoie une nouvelle valeur d'un même type ou d'un type différent.

data:foo.parameter

D'un point de vue technique, ces paramètres sont des données contenues dans un objet et qui renvoient une nouvelle valeur :
Représentation des ressources
"data": {
  "foo": value,
         { "parameter": value }
}


Paramètres des données "string"

Ces paramètres s'appliquent aux données et valeurs de types string, url, image, date, locale et message.
Ressources
{
  "size": number,
  "length": number,
  "escaped": string,
  "jsEscaped": string,
  "jsonEscaped": string,
  "cssEscaped": string
}

Fiches Paramètres Signification Résultat
Longueur d'une chaine length size Longueur d'une chaîne de caractères. number
Échappement de la chaîne escaped Fournit l'équivalent HTML échappé de la chaîne de caractères. string
jsEscaped Fournit l'équivalent JS échappé de la chaîne de caractères.
jsonEscaped Fournit l'équivalent JSON échappé de la chaîne de caractères.
cssEscaped Fournit l'équivalent CSS échappé de la chaîne de caractères.


Paramètres des données "url"

Ces paramètres s'appliquent aux données et valeurs de types url.
Représentation des ressources
{
  "canonical": URL,
  "http": URL,
  "https": URL
}

Fiches Paramètres Signification Résultat
URL canonique canonical Renvoie l'url canonique de l'url courante. URL
HyperText Transfer Protocol Secure http Renvoie l'url avec le protocole http.
https Renvoie l'url avec le protocole https.


Paramètres des données "image"

Ces paramètres s'appliquent aux données et valeurs de types image.
Représentation des ressources
{
  "isResizable": boolean,
  "isYoutube": boolean,
  "youtubeMaxResDefaultUrl": image,
  "width": number,
  "height": number
}

Fiches Paramètres Signification Résultat
Image redimensionnable isResizable Vérifie si l'image peut être redimensionnée avec les opérateurs d'images. boolean
Image YouTube isYoutube Vérifie si l'image provient de YouTube.
youtubeMaxResDefaultUrl Fourni l'URL de la vignette maxresdefault.jpg des vidéos YouTube. image
Dimensions de l'image width Extrait la largeur de l'image (Si mentionné explicitement) number
height Extrait la hauteur de l'image (Si mentionné explicitement)


Paramètres des données "date"

Ces paramètres s'appliquent aux données et valeurs de types date.
Compatibilité : Uniquement Gadget version 2.
Représentation des ressources
{
  "iso8601": string,
  "year": number,
  "month": number,
  "day": number,
  "dayOfWeek": number,
  "dayOfMonth": number,
  "dayOfYear": number
}

Fiches Paramètres Signification Résultat
Format ISO 8601 iso8601 Renvoie la date au format ISO 8601. string
Numéro du jour / mois / année day dayOfMonth Renvoie le jour du mois number
month Renvoie le mois (1 pour janvier, 2 pour février, etc)
year Renvoie l'année
dayOfWeek Renvoie le jour de la semaine (1 pour lundi, 2 pour mardi, etc)
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)


Paramètres des données "locale"

Ces paramètres s'appliquent aux données et valeurs de types locale.
Représentation des ressources
{
  "name": string,
  "language": string,
  "country": string,
  "variant": string,
  "script": string,
  "languageDirection": string,
  "languageAlignment": string
}

Fiches Paramètres Signification Résultat
Paramètres de localisation name Le nom de la langue courante
"English" pour l'anglais, "French" pour le français, etc.
string
language L’abréviation de la langue courante
"en" pour l'anglais, "fr" pour le français, etc.
country Pays de la langue courante
"fr-FR" pour la France, "fr-CA" pour le Canada, "fr-BE" pour la Belgique, "fr-CH" pour la Suisse, etc.
variant La variante de la langue courante
"fr-BE-wa" pour le wallon en Belgique, etc.
Sens de lecture et alignement languageDirection Sens de lecture de la langue courante
"ltr" de gauche à droite ou "rtl" de droite à gauche.
(Équivalent de data:blog.languageDirection).
languageAlignment Alignement de lecture de la langue courante
"left" à partir de la gauche.
"right" à partir de la droite.
(équivalent de data:skin.vars.startSide).


Paramètres des tableaux

Ces paramètres s'appliquent aux array.

(inclus: array[object], array[string], array[boolean], array[number], array[URL], array[image] et array[date]).
Ressources
{
  "size": number,
  "length": number,
  "empty": boolean,
  "notEmpty": boolean,
  "any": boolean,
  "first": Child type of the array,
  "last": Child type of the array
}

Fiches Paramètres Signification Résultat
Longueur du tableau length size Nombre de sets dans un tableau. number
Premier et dernier set first Sélectionne le premier set d'un tableau.
array[object] devient object,
array[string] devient string,
etc...
Child type of the array
last Sélectionne le dernier set d'un tableau.
array[object] devient object,
array[string] devient string,
etc...
Filtre par widget widgetType Sélectionne les sets d'un tableau d'un même type de gadget.
S'applique uniquement au tableau data:widgets (Layouts Version 3)
array[object]
Filtre par option itemName Sélectionne le set d'un tableau correspondant au nom de l'item.
S'applique uniquement à ces tableaux (Layouts Version 3) :
object
Tableau vide empty Indique si le tableau est vide. boolean
notEmpty any Indique si le tableau n'est pas vide.


Paramètres 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
Fiches Skin type Paramètres Signification Data Type
output
Skin Type
output
Paramètres Arrière-plan skin(background) image Extrait l'url de l'image image indisponible
color Extrait le code de couleur skin(color)
Paramètres de polices skin(font) size Extrait la taille de la police string skin(length)
family Extrait le nom de la police skin(string)
Paramètres des couleurs skin(color) transparent Converti le code de couleur en un code de couleur RGBA transparent
inverse Converti le code de couleur en un code de couleur RGBA inversé.
red Extrait le code RGB de couleur rouge.
Nombre compris entre 0 et 255.
green Extrait le code RGB de couleur verte.
Nombre compris entre 0 et 255.
blue Extrait le code RGB de couleur bleue.
Nombre compris entre 0 et 255.
alpha Extrait le niveau de transparence du code de couleur RGBA.
Nombre compris entre 0.0 et 1.0.


Les autres références XML

Posts les plus consultés de ce blog