data:widgets[i].footerBylines
- Blogger Data Documentation
![Blogger - data:widgets[i].footerBylines](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgH2YpvhtBrgwiY6SacRq5UR531E_fY8xXOWIR-Q7C-F6nIyRG5jsS-oe-lI1BEHCz8a8OaOLVEd3q9gUdNI0LMu-Ran683eA39aFbBm71K9oOn6p7EhWEK7cHeoFQF0KWfF0mYAKjTPNzR/s600-rw/widgets-footerBylines.jpg)
Data Type | Gadget Version 1 | Gadget Version 2 |
---|---|---|
array[Object] | Inexistant | Global |
- Description de l'ensemble
data:widgets[i].footerBylines
est un tableau universel Blogger contenant les items en relation avec les lignes des options des articles actives et positionnées dans le pied de l'article.- 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 1Garantie d'usage : InexistantAucune prioritéThème Version 2Garantie d'usage : InexistantAucune prioritéThème DynamiqueGarantie d'usage : InexistantAucune prioritéThème Version 3Garantie d'usage : OuiPriorité haute
- Disponibilité par défaut par type de pages
- Toutes les pages.
- Disponibilité par type de gadgets
- Gadget Blog.
- Longueur maximum de l'ensemble
- 3 lignes : Post-footer-line 1, 2 et 3.
- Set de réglages XML
- Disponible.
- Condition additionnelle
- Aucune.
- Ensemble universel apparenté
widgets[i].headerByline
Table des matières
Ressources
Échantillonnage principal et les réglages du tableau
widgets:
footerBylines: array,
size: number,
length: number,
empty: boolean,
notEmpty: boolean,
any: boolean,
first: object,
last: object
Échantillonnage des items du tableau
widgets:
footerBylines:
regionName: string,
items: array
Parenté - Enfant de :
- Global
widgets
footerBylines
Implémentation des items du tableau
Le tableau étant emboîté dans plusieurs tableaux, le choix de la méthode d'implémentation 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 :
- Filtres par type de gadget
- Filtres premier et dernier set d'un tableau
- Les opérateurs de tableaux
- Les opérateurs Lambdas
Méthode d’Aliasing de l’Array
<b:loop values='data:widgets.Blog.first.footerBylines' var='byline'>
<!-- Tag -->
<data:byline.ITEM_NAME/>
<!-- Attribute value -->
<b:eval expr='data:byline.ITEM_NAME'/>
</b:loop>
L’Alias Array Method est utilisée pour parcourir un tableau (Array
) en stockant temporairement chaque élément dans une variable avec <b:loop>
. Cette approche est indispensable, car il est impossible d’accéder directement aux indices d’un tableau sans une boucle.
Indice de l'item
<b:loop values='data:widgets.Blog.first.footerBylines' var='byline' index='i'>
<!-- Index (number) -->
<data:i/>
<!-- Index [i] -->
<b:eval expr='data:widgets.Blog.first.footerBylines[i].ITEM_NAME'/>
<!-- Index [i+1] -->
<b:with value='data:i + 1' var='next'>
<b:eval expr='data:widgets.Blog.first.footerBylines[next].ITEM_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.footerBylines[prev].ITEM_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]
.
Sens inverse de la boucle
<!-- REVERSE EXPLICIT -->
<b:loop values='data:widgets.Blog.first.footerBylines' var='byline' reverse='true'>
<data:byline.ITEM_NAME/>
</b:loop>
<!-- REVERSE CONDITION -->
<b:loop values='data:widgets.Blog.first.footerBylines' var='byline' expr:reverse='data:view.isPost'>
<data:byline.ITEM_NAME/>
</b:loop>
Le sens de lecture du tableau peut être inversé en injectant l'attribut reverse
dans la balise <b:loop>
. La valeur de l'attribut doit être true
(vrai).
Dans nos exemples, nous utilisons 2 méthodes.
- La première, est une valeur explicite permanente.
- Dans la 2e méthode, nous ajoutons une expression booléenne qui inversera la boucle que si le résultat est vrai.
Les réglages du tableau
Les réglages sont des items contenus dans l'objet du tableau qui renvoient une nouvelle valeur. Dans la syntaxe, ils s'ajoutent à la suite du nom du tableau.
Introduction aux réglages des données
Les réglages autorisés pour ce tableau sont :
Premier et dernier item du tableau
<!-- FIRST LINE -->
<b:eval expr='data:widgets.Blog.first.footerBylines.first.ITEM_NAME'/>
<!-- LAST LINE -->
<b:eval expr='data:widgets.Blog.first.footerBylines.last.ITEM_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.
Longueur du tableau
<!-- WITH SIZE -->
<data:widgets.Blog.first.footerBylines.size/>
<!-- WITH LENGTH -->
<data:widgets.Blog.first.footerBylines.length/>
Les suffixes size
et length
permettent de connaître le nombre de set dans ce tableau. Le résultat sera une valeur numérique.
Ce tableau est vide ?
<!-- EMPTY -->
<b:if cond='data:widgets.Blog.first.footerBylines.empty'></b:if>
<!-- NOT EMPTY -->
<b:if cond='data:widgets.Blog.first.footerBylines.notEmpty'></b:if>
<!-- ANY -->
<b:if cond='data:widgets.Blog.first.footerBylines.any'></b:if>
Pour savoir si ce tableau n'est pas vide, appliquez le suffixe empty
au tableau.
Pour vérifier si ce tableau contient des sets, appliquez les suffixes notEmpty
ou any
au tableau.
Quelque soit le suffixe, l'expression renverra une valeur booléenne.
Intégration dans des opérations
Des opérateurs peuvent traiter les tableaux et leur contenu. Le nombre de combinaisons étant très élevé, nous vous fournissons uniquement que quelques exemples basics.
Inclure les sets jusqu'à / à partir de
<b:with value='data:widgets.Blog.first.footerBylines' var='bylines'>
<!-- HALF ARRAY LENGTH (POSITIVE INTEGER) -->
<b:with value='(data:bylines.length - (data:bylines.length % 2)) / 2' var='half'>
<!-- TAKE (FIRST HALF) -->
<b:loop values='data:bylines take data:half' var='byline'>
<b:eval expr='data:byline.ITEM_NAME'/>
</b:loop>
<!-- SKIP (SECOND HALF) -->
<b:loop values='data:bylines skip data:half + 1' var='byline'>
<b:eval expr='data:byline.ITEM_NAME'/>
</b:loop>
</b:with>
</b:with>
take
et skip
sont deux opérateurs de tableaux qui permettent de contrôler le nombre de sets à inclure dans la boucle.
take
inclu jusqu'au énième set, tandis que skip
inclu à partir du énième set.
Dans notre exemple, nous divisons la longueur totale du tableau par 2 et nous traitons la 1ère moitié et la seconde moitié du tableau dans 2 boucles séparées.
Plage de nombres
<b:with value='data:widgets.Blog.first.footerBylines' var='bylines'>
<b:if cond='data:bylines.any'>
<!-- CHRONOLOGICAL -->
<b:loop values='0 to data:bylines.size - 1' var='number'>
<b:eval expr='data:bylines[number].ITEM_NAME'/>
</b:loop>
<!-- REVERSE -->
<b:loop values='data:bylines.size - 1 to 0' var='number'>
<b:eval expr='data:bylines[number].ITEM_NAME'/>
</b:loop>
</b:if>
</b:with>
to
est un opérateur qui génère une plage de nombres.
Dans cet exemple, nous utilisons l'opérateur comme indice. Ce qui permet de controler le sens de lecture de la boucle.
Opérations Lambdas
<b:with value='data:widgets.Blog.first.footerBylines' var='bylines'>
<!-- CONDITION -->
<b:if cond='data:bylines all (byline => byline.ITEM_NAME)'></b:if>
<!-- COUNT -->
<b:eval expr='data:bylines count (byline => byline.ITEM_NAME)'/>
<!-- FILTER -->
<b:loop values='data:bylines where (byline => byline.ITEM_NAME)' var='byline'>
<b:eval expr='data:byline.ITEM_NAME'/>
</b:loop>
<!-- MAPPING -->
<b:loop values='data:bylines map (byline => byline.ITEM_NAME)' var='byline'>
<b:eval expr='data:byline'/>
</b:loop>
</b:with>
Un lambda est une expression qui évalue le contenu d'un tableau. Selon l'opérateur, on peut obtenir une condition, un compteur, un filtre ou un mappage d'après un ou plusieurs critères spécifiques au contenu de ce tableau.
Dans nos exemples, nous reprenons la syntaxe basique de chaque opérateur avec comme critère un quelconque item du tableau. Ce critère peut être une opération plus complexe.
Alias dans le modèle
Cette section permet d'identifier les emplacements dans le fichier XML où la donnée est implémentée sous différents alias. L’alias peut être identique à la clé d’origine ou être une adaptation spécifique à une ou plusieurs inclusions.
Dans le tableau ci-dessous, nous ne mentionnons que les assignations directes sans manipulation de la valeur, à l'exception des réglages appliqués par suffixe.
Alias | ID Inclusion | Balisage |
---|---|---|
widgets.Blog.first.footerBylines |
footerBylines |
Original |