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.
Table des matières
La syntaxe
<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'identifiantmaindans 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 |
|---|---|---|---|---|
|
Identifiant unique de l'inclusion. Chaque balise |
HTML classic | Interdit | Obligatoire | |
|
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 |
|---|---|---|---|---|
|
Nom de l'identifiant l'inclusion. L'identifiant de la balise |
HTML classic | Autorisé | Obligatoire |
|
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 |
XHTML Blogger | Autorisé | Facultative | |
|
Condition d'exécution de l'inclusion. La valeur attendue doit être boolean ( 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.
<b:includable id='main'>
<b:include name='super.main'/>
</b:includable>
<b:includable id='main'>
<b:include name='super.content'/>
</b:includable>
<b:includable id='content'/>
<b:includable id='main'>
<b:include name='super.content'/>
</b:includable>
<b:includable id='content'>
<!-- empty -->
</b:includable>
