<xsl:include> |
Permet d'inclure une autre feuille de style XSLT. Cet élément permet de placer des transformations communes dans une feuille de style séparée, puis d'inclure les modèles de cette feuille de style à tout moment. Contrairement à <xsl:import>, tous les modèles inclus avec <xsl:include> ont la même priorité que ceux de la feuille de style d'inclusion. Autre différence, <xsl:include> peut apparaître à un emplacement quelconque dans une feuille de style alors que <xsl:import> ne peut apparaître qu'au début.
Catégorie
Elément de niveau supérieur
Attributs obligatoires
href Définit l'URI de la feuille de style incluse.
Attributs facultatifs
Aucun.
Contenu
Aucun. <xsl:include> est un élément vide.
Apparaît dans
L'élément <xsl:include> est un élément de niveau supérieur qui ne peut apparaître que sous forme d'enfant de l'élément <xsl:stylesheet>.
Défini dans
XSLT section 2.6.1, Inclusion d'une feuille de style.
Exemple
L'élément <xsl:include> permet de diviser des feuilles de style en fragments plus petits. (ces fragments sont généralement plus facile à réutiliser). Dans ce cas précis (voir chapitre 9), il est question de plusieurs feuilles de style différentes, chacune contenant des modèles destinés à une utilisation spécifique. Voici à quoi ressemble l'élément <xsl:include> :
    <xsl:include href="toot-o-matic-variables.xsl"/>

    <xsl:include href="xslt-utilities.xsl"/>
    <xsl:include href="dw-style.xsl"/>

    <xsl:include href="build-main-index.xsl"/>
    <xsl:include href="build-section-indexes.xsl"/>
    <xsl:include href="build-individual-panels.xsl"/>
    <xsl:include href="build-graphics.xsl"/>
    <xsl:include href="build-pdf-file.xsl"/>
    <xsl:include href="build-zip-file.xsl"/>
Segmenter les feuilles de style de cette manière peut également faciliter le débogage. Dans cet exemple, toutes les règles de création d'un fichier PDF figurent dans la feuille de style build-pdf-file.xsl. Si les fichiers PDF ne sont pas générés correctement, il y a de grandes chances pour le problème provienne de la feuille de style build-pdf-file.xsl. Tous les éléments visuels des pages HTML générées sont créés dans la feuille de style dw-style.xsl. Pour modifier l'aspect de l'ensemble des pages HTML, il suffirait de modifier les modèles de la feuille de style dw-style.xsl.