extendableItems : Listes extensibles - Blogger XML Documentation
![Blogger - extendableItems [Common]](https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEghoXCur3VATnFsy2Gh5pVDClprlZAPwMi80fxgHSo0f3UdgkcrG-BY_iFwS-z5AS33fi3PCPX-75xv-K0TJXiY27GdYSYGWPZQvSKlRhxZwYgFRyuiNDVrUb7Lf8czndoavk6g0OhwirGA/s600-rw/extendableItems-Common.jpg)
- Description de l'inclusion
extendableItemsest l'une de ces inclusions en raison de leur super pouvoir d'invisibilité, qui paraissent à la fois étranges et mystérieuses et qui pourtant, comme son nom l'indique en anglais, n'est destinée qu'à déployer une liste d'items.
Rien que ça ? Non. Détrompez-vous ! Cette inclusion commune a plus d'un atout dans sa manche.- Directives d'usage et niveau de priorité de mise à jour
-
Thème Version 1Garantie d'usage : AbandonnéPriorité indéfinieThème Version 2Garantie d'usage : AbandonnéPriorité indéfinieThème DynamiqueGarantie d'usage : AbandonnéPriorité indéfinieThème Version 3Garantie d'usage : OuiPriorité haute
- Variante par thème
- Inexistante.
- Inclusion de gadget équivalente
- Aucune.
Présentation
On peut considérer l'inclusion extendableItems comme étant la 7e Merveille du monde Bloggerien puisqu'elle est remplie de fonctionnalités pouvant être transposées dans divers développements.
- Ne contenant que des alias vides qui ne demandent qu'à être rempli, c'est l'inclusion parente qui lui fourni les informations.
- C'est également l'inclusion parente qui lui indique le nom de l'inclusion enfant à inclure.
- Elle ajoute des boutons de déploiements en bas d'une liste, si la liste contient plus de « N » items (par défaut 10).
- Elle permet de trancher une liste d'items en 2 parties (à quelques détails près, c'est la version Blogger de la guillotine française).
- Et enfin, elle est commune. Ce qui signifie qu'on peut créer des appels à n'importe quel endroit du
globeblog.
Principalement conçue pour les thèmes officiels Version 3 (dont l’ingénierie fourni gracieusement les CSS et le JS qui font fonctionner l'ensemble), l'inclusion passe à la moulinette les listes des gadgets Libellés, Archive du blog et Liste des contributeurs dans les thèmes « Essential », « Contempo », « Emporio », « Notable » et « Soho ». Bien évidemment, elle peut aussi traiter n'importe quelle liste d'un quelconque tableau.
Contenu de l'inclusion
Le code XML
<b:includable id='extendableItems'> <b:with value='data:limit ?: 10' var='limit'> <div class='first-items'> <b:with expr:var='data:itemSet' value='data:items take data:limit'> <b:include expr:name='data:itemsMarkup'/> </b:with> <b:if cond='data:items.length gt data:limit'> <div class='remaining-items'> <b:with expr:var='data:itemSet' value='data:items skip data:limit'> <b:include expr:name='data:itemsMarkup'/> </b:with> </div> <span class='show-more'> <b:class expr:name='data:buttonClass'/> <data:messages.showMore/> </span> <span class='show-less hidden'> <b:class expr:name='data:buttonClass'/> <data:messages.showLess/> </span> </b:if> </div> </b:with> </b:includable>
Les nœuds parents
| ID Inclusion | Balisage |
|---|---|
cloud |
Contempo
Emporio
Essential
Soho
|
list |
Contempo
Emporio
Essential
Notable
Soho
|
flat |
Contempo
Emporio
Essential
Notable
Soho
|
hierarchy |
Contempo
Emporio
Essential
Notable
Soho
|
teamProfile |
Emporio |
Appel de l'inclusion et paramètres
<b:include name='extendableItems'/>
Présenté tel quel, l'appel ne travaillera pas, puisque le contenu requiert une multitude d'informations qui doivent être mentionnées dans différents alias, soit via l'attribut data dans la balise <b:include> ou un jeu de balises <b:with>.
<b:include data='{ ITEMS }' name='extendableItems'/>
L'objet doit contenir ces items:
| Alias | Signification | - |
|---|---|---|
itemsMarkup |
L'identifiant de l'inclusion enfant. De préférence, celle qui contient la boucle. | Obligatoire |
items |
La donnée contenant le tableau. Par exemple, data:labels dans le gadget « Libellés ». |
Obligatoire |
itemSet |
Le nom du tableau tel qu'il est mentionné dans l'inclusion enfant. Par exemple, « labels » pour la donnée data:labels. |
Obligatoire |
limit |
Le nombre d'items a afficher dans la première partie de la liste. Valeur par défaut : 10. |
Facultatif |
buttonClass |
Le nom de la classe à ajouter dans les balises des boutons de déploiements. | Facultatif |
<b:includable id='main'> <b:include data='{ itemsMarkup: "content", items: data:links, itemSet: "links", limit: 13, buttonClass: "myButton" }' name='extendableItems'/> </b:includable> <b:includable id='content'> <ul> <b:loop values='data:links' var='link'> <li><a expr:href='data:link.target'><data:link.name/></a></li> </b:loop> </ul> </b:includable>
Modifier l'inclusion
L'inclusion peut être modifiée dans un marquage commun.
<b:defaultmarkups> <b:defaultmarkup type='Common'> <b:includable id='extendableItems'> <!-- Add new code for "extendableItems" inclusion here --> </b:includable> </b:defaultmarkup> </b:defaultmarkups>
Lorsque l'inclusion est marquée explicitement dans le thème, la version « BackEnd » n'est plus prioritaire.
Dans ce cas-ci, pour appeler l'inclusion « BackEnd », vous devez mentionner le préfixe super à l'identifiant de l'inclusion.
<!-- Call Custom version --> <b:include name='extendableItems'/> <!-- Call BackEnd version --> <b:include name='super.extendableItems'/>
Disponibilité des variantes de l'inclusion
| Thèmes | FrontEnd | BackEnd |
|---|---|---|
| Original | Inexistant | Original |
| Contempo | Inexistant | Original |
| Emporio | Inexistant | Original |
| Essential | Inexistant | Original |
| Notable | Inexistant | Original |
| Soho | Inexistant | Original |
| Afficher les variantes | ||
