Les balises d'inclusion [b:includable / b:include]

Nous vous rappelons que lorsque vous accédez à ce blog, vous signez automatiquement un accord avec Blogger Code.
Consultez les CGU.


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:includable id='main'>

  <b:include name='content'/>

</b:includable>
<b:includable id='content'>

</b:includable>

  • 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'
              data='ALIAS'>

</b:includable>

Attributs Classification Préfixe "expr:" Signification Valeur expression
id HTML classic interdit Identifiant unique de l'inclusion.
Chaque balise <b:widget> doit contenir au minimum une inclusion, dont une avec l'identifiant main (l'inclusion principale).
Obligatoire
var HTML classic autorisé Le nom d'une variable utilisée avec le set de données dans l'inclusion courante et les inclusions enfants. Facultatif
data XML Blogger Expression autorisé Attribut d'alias. Permet de faire suivre un jeu de données dans l'inclusion courante et 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:.
En savoir plus
Facultatif


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 Classification Préfixe "expr:" Signification -
name HTML classic autorisé L'identifiant de la balise <b:includable> à appeler. Obligatoire
data XML Blogger Expression autorisé 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:.
En savoir plus
Facultatif
cond XML Blogger Expression autorisé 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.
En savoir plus
Facultatif


Classification des inclusions

Famille Description Sources super.inclusion Marquage
Universelle Une inclusion universelle (appelée également inclusion de blog ou inclusion globale) est une inclusion hébergée uniquement du côté des serveurs de Blogger. L'appel peut être mentionné à un endroit quelconque du blog. Son contenu ne peut pas être modifié. Serveur 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 marquage commun. XML Explicite ou/et Serveur 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 Serveur 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. XML Explicite ou/et Serveur Autorisé Autorisé


Les super inclusions

Les super inclusions sont les inclusions originales qui sont stockées du côté 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>


Les autres balises

Posts les plus consultés de ce blog