widget-title : Titre des gadgets - Blogger XML Documentation

Gadget Version 1	Gadget Version 2	Balisage
Common	Common	Original

Description de l'inclusion

widget-title est l'identifiant d'une inclusion commune destinée aux Thèmes Version 3 et aux gadgets Version 2. Cette inclusion affiche le titre du gadget et prend en charge quelques fonctionnalités supplémentaires.

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.

Ajouter un titre au gadget

Rien de plus simple, chaque gadget dispose d'un panneau de configuration contenant une entrée pour mentionner le titre. Il vous suffit de remplir la cellule.

• UI
• Mise en page
• Modifier un gadget
• Titre

Contenu de l'inclusion

L'inclusion widget-title est une inclusion commune hébergée par Blogger. Le code complet n'est pas fourni directement dans les thèmes.
D'ailleurs, vous pouvez constater que le code ne se limite pas à l'ajout d'une simple balise de titre <h3>, mais qu'elle fourni un certain nombre de fonctionnalités spécifiques à la 3e génération des thèmes Officiels Blogger.

• Code XML
• Nœuds parents

Le code XML

<b:includable id='widget-title'>
  <b:if cond='data:renderAsDetails'>
    <summary>
      <div class='collapsible-title'>
        <h3 class='title'>
          <b:if cond='data:defaultTitle or data:title'>
            <b:eval expr='data:defaultTitle ?: data:title'/>
          <b:else/>
            <data:messages.widget/>
          </b:if>
        </h3>
        <b:include data='{ iconClass: "chevron-down" }' name='chevronDownIcon'/>
        <b:include data='{ iconClass: "chevron-up" }' name='chevronUpIcon'/>
      </div>
    </summary>
  <b:elseif cond='data:defaultTitle or data:title'/>
    <h3 class='title'>
      <b:eval expr='data:defaultTitle ?: data:title'/>
    </h3>
  </b:if>
</b:includable>

Les nœuds parents

ID Inclusion	Balisage
main	Original
main	Original
main	Original
main	Original
main	Notable
main	Contempo Essential
widgetNotAvailableInPreview	Original

Appel de l'inclusion et paramètres

<b:include name='widget-title'/>

Présenté tel quel, l'appel se contentera d'afficher un simple titre dans une balise de titre <h3>.
Pour activer les fonctionnalités « cachées », il faut créer un objet de paramètres qui doit être ajouté dans un attribut data ou définir les valeurs des alias dans des balises <b:with>.

<b:include data='{ ITEMS }' name='widget-title'/>

L'objet peut contenir ces items:

Alias	Signification	-
defaultTitle	Définir un titre par défaut.	Facultatif
title	Remplacer le titre original par une nouvelle valeur.	Facultatif
renderAsDetails	Permet d'ajouter des balises supplémentaires pour créer un menu dépliant. Valeur par défaut : false.	Facultatif

Exemple 1

<b:include data='{ defaultTitle: "My widget" }'
           name='widget-title'/>

Exemple 2

<b:include data='{ defaultTitle: data:messages.widget }'
           name='widget-title'/>

Activer le menu dépliant

C'est une particularité de la 3e génération des thèmes Blogger. Lorsque le gadget est situé dans la colonne latérale d'un thème officiel, le titre peut devenir un menu dépliant avec des chevrons « haut » et « bas ». Cette solution est appliquée automatiquement aux gadgets Label et Archive.

Pour pouvoir appliquer le système aux autres gadgets, vous devez carrément remplacer l'appel de l'inclusion widget-title par :

<details class='collapsible extendable'>
  <b:attr cond='CONDITION' name='open' value='open'/>
  <b:include data='{ renderAsDetails: true }'
             name='widget-title'/>
</details>

Le fichier JS qui gère le déploiement des gadgets reconnaît uniquement les widgets « Libellés » et « Archive du blog ». Pour qu'un gadget différent soit totalement pris en considération, il faut ajouter une balise b:class à l'intérieur de l'inclusion « main » du gadget.

La valeur peut être Label ou BlogArchive.

<b:includable id='main'>
  <b:class name='Label'/>

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='widget-title'>

      <!-- Add new code for "widget-title" 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='widget-title'/>

  <!-- Call server version -->
  <b:include name='super.widget-title'/>

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