extendableItems : Listes extensibles - Blogger XML Documentation

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

• Code XML
• Nœuds parents

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

Légende :

• Original : Balisage original
• Original+ : Balisage original (super)
• Theme : Balisage spécifique au thème
• Inexistant : Balisage inexistant

Thèmes	Éditeur XML	Cloud
Original	Inexistant	Original
Contempo	Inexistant	Original
Emporio	Inexistant	Original
Essential	Inexistant	Original
Notable	Inexistant	Original
Soho	Inexistant	Original
Afficher les variantes

Les inclusions Communes

• backArrowIcon
• chevronDownIcon
• chevronUpIcon
• closeIcon
• commentIcon
• defaultAvatarIcon
• emailIcon
• extendableItems
• facebookIcon
• flatBloggerIcon
• footerBylinesOverride
• forwardArrowIcon
• headerBylineOverride
• linkIcon
• maybeAddShareButtons
• menuIcon
• noContentPlaceholder
• openGraphMetaData
• pinterestIcon
• postMetadataJSON
• postSnippet
• reportAbuse
• responsiveImage
• responsiveImageStyle
• searchIcon
• shareIcon
• sharingOtherIcon
• skipNavigation
• svgIcon
• svgIconButton
• twitterIcon
• verticalMoreIcon
• widget-title
• widgetNotAvailableInPreview

Retourner dans la vue d'ensemble des inclusions communes