La balise Include ins�re le code du mod�le de pr�sentation pris en r�f�rence dans l'�l�ment du mod�le de pr�sentation en cours. Le second mod�le de pr�sentation ne peut �tre repr�sent� que par un chemin d'acc�s (templatepath).
Telle une instruction Include de serveur, la balise Include sert le plus souvent � afficher les en-t�tes, les bas de page et autres types de contenu r�p�titif. L'utilisation de la balise Include garantit qu'un contenu r�p�titif appara�t uniform�ment sur toutes les pages et que sa mise � jour est simplifi�e : vous vous contentez de modifier le fichier du mod�le inclus au lieu de changer chaque page du mod�le l'utilisant.
Les mod�les de pr�sentation inclus sont un peu comme des sections coup�es et coll�es dans le mod�le de pr�sentation en cours. � l'ex�cution du mod�le, vous pouvez vous servir du mod�le inclus pour acc�der � l'�l�ment publi�, comme s'il s'agissait du mod�le principal de cet �l�ment.
Comme les en-t�tes et les bas de page peuvent servir � stocker toutes les informations de format et de mise en page, la cr�ation du mod�le principal consiste � simplement renseigner une cellule de tableau. Par exemple, en extrayant les sections comment�es pour les placer dans trois mod�les de pr�sentation, vous pourriez utiliser plusieurs types d'�l�ments diff�rents pour le mod�le d'�l�ment principal, comme dans l'exemple ci-dessous :
<!-- D�but du mod�le d'en-t�te inclus :
-->
<html>
<head><title><pcs:value expr="item.title ∨ item.name"></pc:value></title></head>
<body>
<table border="1" height="100%">
<tr>
<td
colspan="2">Incorporer le contenu de la banni�re du haut</td>
</tr>
<tr>
<td
width="10%">Incorporer la navigation de gauche</td>
<td
width="90%" align="left" valign="top">
<!-- Fin du mod�le d'en-t�te -->
<!-- D�but du mod�le d'�l�ment principal
-->
<pcs:include templatepath="ArticleHeader"><h1>ArticleHeader
est absent !</h1></pcs:include>
<h1><pcs:value expr="headline">EN-T�TE</pcs:value></h1>
<p><pcs:value expr="body">TEXTE</pcs:value>
<pcs:include templatepath="ArticleFooter"><h1>ArticleFooter
est absent !</h1></pcs:include>
<!-- Fin du mod�le d'�l�ment principal -->
<!-- D�but du mod�le de bas de page
inclus -->
</td>
</tr>
<tr><td colspan="2">Le
bas de page se place ici</td></tr>
</table>
</body>
</html>
<!-- Fin du mod�le de bas de page inclus -->
Si vous souhaitez afficher un message apparaissant au cas o� le mod�le serait introuvable, tapez celui-ci dans la zone Texte en cas d'�chec de INCLUDE. (Ce texte figure entre les balises <pcs> d'ouverture et de fermeture de la zone Balise PCS.)
|
Attribut |
Description |
| Syntaxe | <pcs:include templatepath="path">texte par d�faut</pcs:include> |
|
Exemple |
<pcs:include templatepath="/includes/footer">Copyright 2004</pcs:include> |
Si le mod�le sp�cifi� n'est pas accessible, l'instruction Include �choue et le contenu de l'�l�ment est �valu� � sa place. Dans cet exemple, le texte � Copyright 2004 � est affich�.