ThéorieRéférences XMLBalises

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

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 dans une balise b:widget.
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>

  • Chaque b:includable est imbriqué dans une balise b:widget.
  • Une balise b:widget ne peut contenir que des balises b:includable, dont une est obligatoire avec l'identifiant main.
  • Les balises b:includable ne peuvent pas être imbriquées.
  • Les balises b:include sont imbriquées dans les balises b:includable.
  • Les balises b:include ne sont utilisées que dans les widgets, excepté quelques balises b:include fournies par Blogger en mode lecture seule (voir le chapitre "inclusions verrouillées").


Les paramètres de la balise b:includable

Plusieurs paramètres 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>

Paramètre Signification -
id Identifiant unique de l'inclusion.
Chaque gadget doit contenir au minimum une inclusion, dont une avec l'identifiant main (l'inclusion principale).
Obligatoire
var Le nom d'une variable utilisé avec le set de données dans cette inclusion et les inclusions enfants. Facultatif
data Faire suivre ce jeu de donnée dans l'inclusion courante et dans les inclusions enfants.
La valeur peut-être :
  • Le nom d'un jeu de données
  • Le nom d'une variable contenant un jeu de données
  • Une donnée
  • Des alias
Le jeu de données est écrasé lorsqu'un autre jeu de donnée est défini dans un nœud enfant.
Facultatif


Les paramètres de la balise b:include

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

<b:include cond='CONDITION'
           data='DICTIONARY_NAME'
           name='INCLUDABLE_ID'/>

Paramètre Signification -
cond Condition de l'appel de l'inclusion.
La valeur attendue doit être booléenne. Elle peut être une donnée ou une expression Blogger :
  • Une donnée booléenne renvoie toujours une valeur true (vraie) ou false (fausse).
  • Les autres types de données sont toujours vraies si la donnée n'est pas vide (excepté les array (tableaux)).
  • Le résultat d'une expression Blogger doit être true (vraie) ou false (fausse).
Pour en savoir plus sur les expressions Blogger, consultez les fiches des catégories Opérateurs et Types de données.
Facultatif
data Faire suivre ce jeu de donnée dans les inclusions enfants.
La valeur peut-être :
  • Le nom d'un jeu de données
  • Le nom d'une variable contenant un jeu de données
  • Une donnée
  • Des alias
Le jeu de données est écrasé lorsqu'un autre jeu de donnée est défini dans un nœud enfant.
Facultatif
name L'identifiant de la balise b:includable à appeler. Obligatoire


Les inclusions serveur

Les inclusions serveurs sont des exceptions en comparaison avec les inclusions traditionnelles que l'on retrouvent dans les gadgets.
b:includable renferme un contenu XML qui n'est pas accessible pour les utilisateurs, tandis que b:include appelle ce contenu.
Généralement, ces balises sont fournies automatiquement dans tous les modèles officiels et dans les gadgets en fonction de leur utilité.
Le contenu est géré par l’ingénierie Blogger afin de vous épargner certaines lourdes tâches et dans certains cas, alléger le poids de votre fichier.
Certaines inclusions utilisent un dictionnaire de données globales pouvant être appelées depuis un endroit quelconque dans le fichier XML du modèle et tandis que d'autres utilisent un dictionnaire spécifique à des gadgets et ne peuvent être appelées que depuis le code XML de ce gadget.
Pour écrire ces inclusions fermées, l’ingénierie Blogger emploie le même language XML et les mêmes dictionnaires de données que vous utilisez dans votre modèle. Ils est donc très facile de réécrire le contenu de ces inclusions dans vos propres modèles.

Pour en savoir plus, consultez les fiches techniques de chaque inclusion serveur dans la catégories b:includable - Server version.

Dernière modification :
Assistance publique pour le produit Blogger sur les Forums d'aides :

Certifiée par Google - Experte Platine TC (Ambassador & Advanced Troubleshooter):
  • Affectation Google France, produit Blogger, du 11/07/2011 au 28/07/2014.
  • Affectation Google US, produit Blogger depuis le 28/07/2014.

Posts les plus consultés de ce blog

DéveloppementsFichiers XML
Populaire
ThéorieRéférences XMLParamètres des données
Le paramètre Image redimensionnable [isResizable]
Populaire
DéveloppementsFichiers XML
Résumés des articles avec images réactives [Pack 2016]
Populaire