widget-title : Titre des gadgets - Blogger XML Documentation

Blogger - widget-title [Common]
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.

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

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


Populaires cette semaine