data:widgets[i].allBylineItems[i].name - Blogger Data Documentation

Extrait de la documentation personnelle de
Blogger - data:widgets[i].allBylineItems[i].name
Data Type Gadget Version 1 Gadget Version 2
string Inexistant Global
Description de la donnée
data:widgets[i].allBylineItems[i].name est une donnée universelle Blogger contenant le nom technique correspondant à une option des articles active.
Intégration dans le code XML
Dans les nœuds enfants de la balise <html>, excepté à l'intérieur des marqueurs <![CDATA[ ]]>.
Directives d'usage et niveau de priorité de mise à jour
Thème Version 1
Garantie d'usage : Inexistant
Aucune priorité
Thème Version 2
Garantie d'usage : Inexistant
Aucune priorité
Thème Dynamique
Garantie d'usage : Inexistant
Aucune priorité
Thème Version 3
Garantie d'usage : Oui
Priorité haute
Disponibilité par défaut par type de pages
Toutes les pages.
Disponibilité par type de gadgets
Gadget Blog.
Longueur maximum de la valeur
Indéfini.
Set de réglages XML
Disponible.
Condition additionnelle
L'option doit être activée.
Données universelles apparentées
widgets[i].headerByline.items[i].name
widgets[i].footerBylines[i].items[i].name
Donnée de gadgets apparentée
Aucune.

Ressources

Échantillonnage des ressources


  widgets: 
    allBylineItems: 
      name: string,
        
          size: number,
          length: number,
          escaped: string,
          jsEscaped: string,
          jsonEscaped: string,
          cssEscaped: string

Parenté - Enfant de :

Caractéristiques et valeurs

L'ordre de la liste est établi via le panneau de configuration du widget Blog :

  • UI
  • Mise en page
  • Modifier widget Blog
  • Organiser les éléments
Option Valeur
Boutons de partage share
Lien vers les commentaires comments
Localisation location
Date de publication timestamp
Auteur de la publication author
Liste des libellés labels
Bouton d'envoi par email icons

Implantation de la donnée

La donnée étant emboîtée dans plusieurs tableaux, le choix de la méthode d'implantation dépendra du résultat que vous voulez obtenir.
Pour réduire le temps de réponse, limitez le nombre de boucles et privilégiez l'usage de filtres :

Syntaxe basique

<b:loop values='data:widgets.Blog.first.allBylineItems' var='item'>

  <!-- Tag -->
  <data:item.name/>

  <!-- Attribute value -->
  <b:eval expr='data:item.name'/>

</b:loop>

Filtre par option

<!-- SHARE -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.share.name'/>

<!-- AUTHOR -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.author.name'/>

<!-- TIMESTAMP -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.timestamp.name'/>

<!-- COMMENTS -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.comments.name'/>

<!-- LABELS -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.labels.name'/>

<!-- LOCATION -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.location.name'/>

<!-- MAIL BUTTON -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.icons.name'/>

<!-- SHARE -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "share")).name'/>

<!-- AUTHOR -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "author")).name'/>

<!-- TIMESTAMP -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "timestamp")).name'/>

<!-- COMMENTS -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "comments")).name'/>

<!-- LABELS -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "labels")).name'/>

<!-- LOCATION -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "location")).name'/>

<!-- MAIL BUTTON -->
<b:eval expr='(data:widgets.Blog.first.allBylineItems filter (item => item.name == "icons")).name'/>

Le tableau data:widgets[i].allBylineItems peut être filtré par option et devenir un objet ne contenant plus que les items de cette option. Pour obtenir ce résultat, il existe au moins 2 méthodes :

  • La première méthode, en appliquant le nom de l'option comme suffixe au tableau.

  • La deuxième méthode, en utilisant un filtre lambda.

Indice de l'item

<b:loop values='data:widgets.Blog.first.allBylineItems' var='item' index='i'>

  <!-- Index (number) -->
  <data:i/>

  <!-- Index [i] -->
  <b:eval expr='data:widgets.Blog.first.allBylineItems[i].name'/>

  <!-- Index [i+1] -->
  <b:with value='data:i + 1' var='next'>
    <b:eval expr='data:widgets.Blog.first.allBylineItems[next].name'/>
  </b:with>

  <!-- Index [i-1] -->
  <b:if cond='data:i gt 0'>
    <b:with value='data:i - 1' var='prev'>
      <b:eval expr='data:widgets.Blog.first.allBylineItems[prev].name'/>
    </b:with>
  </b:if>

</b:loop>

L'indice est un nombre entier positif (0 compris) qui représente la position de l'élément dans un tableau. Il peut être intègré directement dans la donnée de cette manière : data:array[index].item. Quant à la donnée, elle doit obligatoirement être dans un attribut d'expression.
Dans notre exemple, nous utilisons l'indice pour retrouver l'élément courant [i], l'élément suivant [i+1] et l'élément précédant [i-1].

Premier et dernier item

<!-- First -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.first.name'/>

<!-- Last -->
<b:eval expr='data:widgets.Blog.first.allBylineItems.last.name'/>

first et last sont des filtres qui permettent d'obtenir respectivement le premier et dernier élément d'un tableau sans avoir à recourir à l'usage d'une boucle.

Mappage

<b:loop values='data:widgets.Blog.first.allBylineItems map (item => item.name)' var='item'>

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

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

</b:loop>

Le mappage est une opération qui consiste à regrouper des items d'un ensemble dans un nouvel ensemble.

Dans ce cas-ci, nous utilisons l'opérateur lambda map.

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 :

Longueur de la chaîne de caractères

<b:loop values='data:widgets.Blog.first.allBylineItems' var='item'>

  <!-- WITH SIZE -->
  <data:item.name.size/>

  <!-- WITH LENGTH -->
  <data:item.name.length/>

</b:loop>

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:loop values='data:widgets.Blog.first.allBylineItems' var='item'>

  <!-- HTML ESCAPED -->
  <data:item.name.escaped/>

  <!-- JS ESCAPED -->
  <data:item.name.jsEscaped/>

  <!-- JSON ESCAPED -->
  <data:item.name.jsonEscaped/>

  <!-- CSS ESCAPED -->
  <data:item.name.cssEscaped/>

</b:loop>

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
bylineByName
Original
footerBylinesOverride
Original
headerBylineOverride
Original
snippetedPostByline
Original

Données dans le même ensemble

data:widgets[i].allBylineItems[i]...
data:widgets[i].allBylineItems

Source & contribution

Google PE Program
Équipe Blogger/Experts Produit Blogger

Classifications, corrélations & échantillonnages

Soraya Lambrechts

Dernière mise à jour

Licence

Ce contenu est protégé par la licence CC BY-NC-ND 4.0

Spotlight

L'Éditeur XML de Thème Blogger : Quand le BackEnd Rencontre le FrontEnd

Image
En 2007, une évolution importante est survenue dans l'univers de Blogger : l'éditeur XML de thème a fait son apparition, brouillant les lignes entre backEnd et frontEnd pour des millions de "Bloggeriens". Mais que signifie cette évolution pour les utilisateurs ? Et surtout, qu'en est-il de la propriété intellectuelle et de la licence de ces thèmes ? Plongeons dans les détails de ce curieux mélange technique tout en tenant compte des Conditions générales d'utilisation (CGU) de Google.
En savoir plus ➤

Populaires cette semaine