Les balises d'inclusion / Inclusion tags : <b:includable>, <b:include>

Blogger - Les balises d'inclusion <b:includable>, <b:include>

Les balises <b:includable> et <b:include> sont comme des tiroirs contenant une séries de codes. <b:includable> renferme le contenu, tandis que <b:include> appelle le contenu.

La syntaxe

XML
<b:widget>
  <b:includable id='main'>

    <b:include name='content'/>

  </b:includable>
  <b:includable id='content'>
  
  </b:includable>
</b:widget>
  • Les balises <b:includable> sont imbriquées dans une balise <b:widget> ou <b:defaultmarkup>.

  • Une balise <b:includable> est obligatoire avec l'identifiant main dans une balise <b:widget>.

  • Les balises <b:includable> ne peuvent pas s'imbriquer.

Les attributs de la balise <b:includable>

Plusieurs attributs peuvent être ajoutés dans la balise. Certains sont requis et d'autres sont facultatifs.

<b:includable id='INCLUDABLE_ID'
              var='VARIABLE_NAME'>

</b:includable>
Attributs Description Classification Préfixe « expr: » Implantation
id

Identifiant unique de l'inclusion.

Chaque balise <b:widget> doit contenir au minimum une inclusion, dont une avec l'identifiant main (l'inclusion principale).

Classification : HTML classic Préfixe « expr: » : Interdit Implantation : Obligatoire
var

Variable de données.

Le nom d'une variable utilisée avec le set de données dans l'inclusion courante et les inclusions enfants.

Classification : HTML classic Préfixe « expr: » : Autorisé Implantation : Facultative

Les attributs de la balise <b:include>

Plusieurs attributs peuvent être ajoutés dans la balise. Certains sont requis et d'autres sont facultatifs.

<b:include cond='CONDITION'
           data='ALIAS'
           name='INCLUDABLE_ID'/>
Attributs Description Classification Préfixe « expr: » Implantation
name

Nom de l'identifiant l'inclusion.

L'identifiant de la balise <b:includable> à appeler.

Classification : HTML classic Préfixe « expr: » : Autorisé Implantation : Obligatoire
data

Attribut d'alias.

Permet de faire suivre un jeu de données dans les inclusions enfants.

La valeur peut-être :

  • Le nom d'une donnée.

  • Un objet de noms de données.

Le contenu de l'alias est écrasé lorsqu'un autre alias est défini dans un nœud enfant.

Les alias définis ne doivent pas contenir le préfixe data:.

Classification : XHTML Blogger Préfixe « expr: » : Autorisé Implantation : Facultative
cond

Condition d'exécution de l'inclusion.

La valeur attendue doit être boolean (true ou false).

Elle peut être une valeur explicite, une donnée ou une expression Blogger.

Classification : XHTML Blogger Préfixe « expr: » : Autorisé Implantation : Facultative

Classification des inclusions

Famille/Description Emplacement Super Inclusion Default Markup

Universelle

Une inclusion universelle (appelée également inclusion de blog ou inclusion globale) est une inclusion hébergée uniquement dans le back-End Blogger. Le code XML n'est pas disponible dans l'éditeur XML du thème.

L'appel peut être mentionné à un endroit quelconque du blog. Son contenu ne peut pas être modifié.

Emplacement : Back-End Interdit Interdit

Commune

Une inclusion commune est une inclusion pouvant travailler aussi bien dans plusieurs gadgets que dans l'ensemble du blog.

L'emplacement de son appel dépend principalement de son contenu.

Une version alternative peut être créée dans le balisage commun par défaut du thème.

Emplacement : Back-End Autorisé Autorisé

Gadget

Une inclusion de gadget est une inclusion ne pouvant travailler que dans un gadget.

L'appel doit être situé obligatoirement à l'intérieur de ce gadget.

Son contenu peut être modifié si le gadget n'est pas en lecture seule.

La version Back-End peut être appelée, si l'inclusion est explicitement marquée dans le gadget et si elle fait partie de la collection du modèle de gadget par défaut.

Emplacement : Éditeur XML ou/et Back-End Autorisé Autorisé

Les super inclusions

Les super inclusions sont les inclusions originales qui sont stockées dans le back-End de Blogger et pouvant être appelées grâce au préfixe super. Pour inclure une super inclusion, l'inclusion dans le modèle de gadget par défaut doit être personnalisée, fermée ou vide.

Inclusion personnalisée
<b:includable id='main'>
  <b:include name='super.main'/>
</b:includable>
Inclusion fermée
<b:includable id='main'>
  <b:include name='super.content'/>
</b:includable>

<b:includable id='content'/>
Inclusion vide
<b:includable id='main'>
  <b:include name='super.content'/>
</b:includable>

<b:includable id='content'>
  <!-- empty -->
</b:includable>

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