extendableItems : Listes extensibles - Blogger XML Documentation

Blogger - extendableItems [Common]
Gadget Version 1 Gadget Version 2 Balisage
Common Common
Original
Description de l'inclusion
extendableItems est 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 1
Garantie d'usage : Abandonné
Priorité indéfinie
Thème Version 2
Garantie d'usage : Abandonné
Priorité indéfinie
Thème Dynamique
Garantie d'usage : Abandonné
Priorité indéfinie
Thème Version 3
Garantie d'usage : Oui
Priorité 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 récipients 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 globe blog.

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

Exemple (avec le gadget « LinkList »)
<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.
En savoir plus
<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 « serveur » n'est plus prioritaire.
Dans ce cas-ci, pour appeler l'inclusion « serveur », vous devez mentionner le préfixe super à l'identifiant de l'inclusion.
En savoir plus
  <!-- Call custom version -->
  <b:include name='extendableItems'/>

  <!-- Call server 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
Légende :
  • Original : Balisage original
  • Original+ : Balisage original (super)
  • Theme : Balisage spécifique au thème
  • Inexistant : Balisage inexistant


Spotlight

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

Populaires cette semaine

Foire aux questions Blogger (Novembre 2021)

Ajouter des boutons à la barre de partage Blogger