Les balises d'inclusion / Inclusion tags : <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:	Implémentation
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).	HTML classic	Interdit	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.	HTML classic	Autorisé	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:	Implémentation
name	Nom de l'identifiant l'inclusion. L'identifiant de la balise <b:includable> à appeler.	HTML classic	Autorisé	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 ou 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:.	XHTML Blogger	Autorisé	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.	XHTML Blogger	Autorisé	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é.	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.	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.	É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>

Balises d'Habillage du thème

• <b:skin> <b:template-skin>

Balises de Structuration du Thème

• <b:section>
• <b:widget>

Balises de Structure des Widgets

• <b:includable> <b:include>
• <b:widget-settings> <b:widget-setting>
• <b:defaultmarkups> <b:defaultmarkup>

Balises de Logique et de Dynamisme

• <b:attr>
• <b:class>
• <b:comment>
• <b:eval>
• <b:if> <b:elseif> <b:else>
• <b:loop>
• <b:message> <b:param>
• <b:switch> <b:case> <b:default>
• <b:tag>
• <b:template-script>
• <b:with>
• <data:foo>
• <![CDATA[]]>

Introduction aux Balises