Partager via

Élément <xsl:include>

  • Article

Inclut un autre fichier XSLT.

<xsl:include
  href = "uri-reference"/>

Attributs

  • href
    Requis. Référence URI (Uniform Resource Identifier) identifiant le fichier XSLT à inclure.

Informations sur les éléments

Nombre d'occurrences

Illimité

Éléments parents

xsl:stylesheet, xsl:transform

Éléments enfants

(Pas d'éléments enfants)

Notes

Un fichier XSLT peut inclure un autre fichier XSLT à l'aide de l'élément <xsl:include>. La valeur de l'attribut href est une référence URI identifiant le fichier à inclure. L'URI relatif se résout par rapport à l'URI de base de l'élément <xsl:include>.

L'élément <xsl:include> n'est autorisé que comme enfant de l'élément <xsl:stylesheet>.

Les inclusions sont traitées par Microsoft® XML Core Services (MSXML) comme si elles se produisaient au niveau de l'arborescence. Notez que ce n'est pas la même chose que la vue DOM (Document Object Model) de l'arborescence XML. La ressource localisée par la valeur de l'attribut href est analysée comme un document XML et les enfants de l'élément <xsl:stylesheet> contenus dans ce document remplacent l'élément <xsl:include> dans le document où est placée l'inclusion. À la différence de <xsl:import>, les règles de modèle incluses ont la même priorité d'importation que celles contenues dans la feuille de style où se fait l'inclusion. Par conséquent, lorsque la feuille de style incluante et la feuille de style incluse contiennent toutes deux une règle de modèle pour un élément, c'est l'ordre du document qui détermine le modèle appelé. Si le modèle de la feuille de style incluante suit le modèle inclus, c'est le premier qui est appelé. Sinon, c'est le modèle inclus.

Une erreur se produit si un fichier XSLT s'inclut lui-même, directement ou indirectement.

Une inclusion multiple d'un même fichier XSLT peut provoquer des erreurs en raison des définitions en double. Les inclusions multiples sont moins évidentes lorsqu'elles sont indirectes. Par exemple, A, B, C et D sont tous des fichiers XSLT. Les fichiers B, C et D incluent d'autres fichiers XSLT, comme suit :

  • B inclut A.

  • C inclut A.

  • D inclut B et C.

Le fichier XSLT D inclut donc indirectement deux fois le fichier XSLT A. Vous pouvez éviter cette erreur en retirant de B tout le contenu autre que l'inclusion de A et en le plaçant dans un fichier XSLT séparé, B1, et en changeant B pour inclure B1 et A. Faites de même avec le fichier C et, enfin, changez D pour inclure A, B1 et C1.

Exemple

La rubrique suivante fournit un exemple de <xsl:include>.