data:image - Blogger Data Documentation

Data Type	Gadget Version 1	Gadget Version 2
image	Aucun gadget	Header

Description de la donnée

data:image est une donnée Blogger du gadget « En-tête de la page » contenant l'URL de la bannière du blog.

Intégration dans le code XML

Dans les nœuds enfants du gadget Header.

Directives d'usage et niveau de priorité de mise à jour

Thème Version 1

Garantie d'usage : Aucune

Aucune priorité

Thème Version 2

Garantie d'usage : Aucune

Aucune priorité

Thème Dynamique

Garantie d'usage : Aucune

Aucune priorité

Thème Version 3

Garantie d'usage : Oui

Priorité haute

Disponibilité par défaut par type de pages

Toutes les pages.

Recadrage de l'image

Taille originale.

Set de réglages XML

Disponible, avec limitation.

Condition additionnelle

Aucune.

Donnée équivalente Gadget Version 1

sourceUrl

Ressources

Échantillonnage des ressources

  widget: 
    type: Header,
    version: 2
  ,
  this: 
    image: image,
      
        isResizable: boolean,
        size: number,
        length: number,
        escaped: string,
        jsEscaped: string,
        jsonEscaped: string,
        cssEscaped: string
      
  

Parenté - Enfant de :

• Header
• this
• image

Caractéristiques et valeurs

Pour activer la donnée, une image doit être ajoutée via le panneau de configuration du gadget :

• UI
• Mise en page
• Modifier gadget Header
• Image

Implantation de la donnée

• Syntaxe basique
• Syntaxe d'uniformisation

Syntaxe basique

<b:includable id='main'>

  <!-- Tag -->
  <data:image/>

  <!-- Attribute value -->
  <b:eval expr='data:image'/>

</b:includable>

Syntaxe d'uniformisation

<b:includable id='main' var='this'>

  <!-- Tag -->
  <data:this.image/>

  <!-- Attribute value -->
  <b:eval expr='data:this.image'/>

</b:includable>

La syntaxe d'uniformisation est une méthode qui consiste à inclure l'item dans un objet afin d'obtenir la formule object.item. Cette méthode permet de faciliter la réutilisation d'inclusions contenant les mêmes jeux de données, même si les items ne sont pas dans le même nœud ou dans le même dictionnaire.

Réglages de la donnée

Les réglages sont des items contenus dans l'objet de la donnée qui renvoient une nouvelle valeur. Ils s'ajoutent à la suite de la donnée.

Introduction aux réglages des données

Les réglages autorisés pour cette donnée sont :

• Est redimensionnable ?
• Longueur
• Échappements

L'image est redimensionnable ?

<b:includable id='main'>

  <!-- IS RESIZABLE ? -->
  <b:if cond='data:image.isResizable'>
    <img expr:src='resizeImage(data:image,1600,"2:1")'/>
  </b:if>

</b:includable>

En ajoutant le paramètre .isResizable à la donnée, la donnée renvoie une valeur booléenne true ou false.
Lorsque la valeur est true, la donnée principale pourra être traitée avec les opérateurs d'images.

Image redimensionnable

Longueur de la chaîne de caractères

<b:includable id='main'>

  <!-- WITH SIZE -->
  <data:image.size/>

  <!-- WITH LENGTH -->
  <data:image.length/>

</b:includable>

Le nombre de caractères de la chaîne peut être obtenu en utilisant les suffixes size ou length.

Longueur de la chaîne de caractères

Échappements de la chaîne de caractères

<b:includable id='main'>

  <!-- HTML ESCAPED -->
  <data:image.escaped/>

  <!-- JS ESCAPED -->
  <data:image.jsEscaped/>

  <!-- JSON ESCAPED -->
  <data:image.jsonEscaped/>

  <!-- CSS ESCAPED -->
  <data:image.cssEscaped/>

</b:includable>

La chaîne de caractères peut être échappée en utilisant les suffixes escaped, jsEscaped, jsonEscaped et cssEscaped.

Échappements de la chaîne de caractères

Récipients dans le thème

Cette section répertorie les emplacements des récipients qui accueillent cette donnée.

ID Inclusion	Balisage
behindImageStyle	Original
image	Original

Données dans le même ensemble

data:this...

• backgroundPositionStyleStr
• description
• height
• image
• imagePlacement
• sectionWidth
• shrinkToFit
• sourceUrl
• title
• useImage
• width

Retourner dans data:{Header}