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
<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'identifiantmain
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 |
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 |
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 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 |
Classification : XML Blogger Expression | Préfixe « expr: » : Autorisé | Implantation : Facultative |
cond |
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. |
Classification : XML Blogger Expression | 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 du côté des serveurs de 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 : 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 balisage commun par défaut du thème. |
Emplacement : 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. |
Emplacement : Éditeur XML 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.
<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>
Les autres balises
<b:attr>
<b:class>
<b:comment>
<b:defaultmarkups>
<b:defaultmarkup><b:eval>
<b:if>
<b:elseif>
<b:else><b:includable>
<b:include><b:loop>
<b:message>
<b:param><b:section>
<b:skin>
<b:template-skin><b:switch>
<b:case>
<b:default><b:tag>
<b:template-script>
<b:widget>
<b:widget-settings>
<b:widget-setting><b:with>
<data:foo>
<![CDATA[]]>