Élément <xsl:output> de XSLT

Éléments XSLT

Définition et utilisation

L'élément <xsl:output> définit le format du document de sortie.

Remarque :<xsl:output> est un élément de niveau supérieur (top-level element), doit être un noeud enfant de <xsl:stylesheet> ou <xsl:transform>.

Syntaxe

<xsl:output
method="xml|html|text|name"
version="string"
encoding="string"
omit-xml-declaration="yes|no"
standalone="yes|no"
doctype-public="string"
doctype-system="string"
cdata-section-elements="namelist"
indent="yes|no"
media-type="string"/>

Attribut

Attribut Valeur Description
method
  • xml
  • html
  • text
  • name
 Optionnel. Définir le format de sortie. Par défaut, c'est XML. Netscape 6 ne prend en charge que "html" et "xml".
version string Optionnel. Définir la version du W3C du format de sortie. (Seulement lorsque method="html" ou method="xml" est utilisé).
encoding string Optionnel. Définir la valeur de l'attribut d'encodage de la sortie.
omit-xml-declaration
  • yes
  • no

Optionnel.

"yes" détermine que la déclaration XML doit être omise dans la sortie (<?xml...?>).

"no" détermine que la déclaration XML doit être incluse dans la sortie. Par défaut, c'est 'no'.
standalone
    • yes
    • no
 Optionnel. Détermine si le processeur XSLT doit produire une déclaration de document indépendant ; cette valeur doit être 'yes' ou 'no'. Par défaut, c'est 'no'. Netscape 6 ne prend pas en charge cette propriété.
doctype-public string Optionnel. Définit l'identificateur public à utiliser dans le DTD. C'est la valeur de l'attribut PUBLIC de la déclaration DOCTYPE dans la sortie.
doctype-system string Optionnel. Définit l'identificateur système à utiliser dans le DTD. C'est la valeur de l'attribut SYSTEM de la déclaration DOCTYPE dans la sortie.
cdata-section-elements namelist Optionnel. Une liste d'éléments séparés par des espaces, les textes des éléments doivent être sortis comme partie CDATA.
indent
  • yes
  • no
 Optionnel. Indique si des espaces blancs doivent être ajoutés lors de la sortie du résultat du résultat ; cette valeur doit être "yes" ou "no". Netscape 6 ne prend pas en charge cet attribut.
media-type string Optionnel. Définit le type MIME de sortie (type de média des données). La valeur par défaut est "text/xml". Netscape 6 ne prend pas en charge cet attribut.

Attribut method

Identifie la méthode utilisée pour sortir le résultat du résultat. Si il n'y a pas de préfixe, il identifie la méthode spécifiée dans ce document, doit être "xml", "html", "text" ou l'un des noms qualifiés non NCName). Si il y a un préfixe, il l'étend et l'identifie comme méthode de sortie.

La sélection de la valeur par défaut de l'attribut method est comme suit. Si l'une des conditions suivantes est vraie, la méthode de sortie par défaut est "html" :

Le nœud racine du résultat contient des éléments sous-jacents.

Le nœud racine du résultat du résultat contient des éléments sous-jacents. Le nom de l'extension de l'élément racine du résultat contient la partie locale "html" (combinaison de casse arbitraire) et une URI d'espace de noms vide.

Tous les nœuds de texte avant le premier élément sous-jacent du nœud racine du résultat ne contiennent que des caractères blancs.

Sinon, la méthode de sortie par défaut est "xml". Si il n'y a pas d'élément <xsl:output> ou si l'élément <xsl:output> ne spécifie pas la valeur de l'attribut method, l'utilisation de la méthode de sortie par défaut est recommandée.

Instance

Exemple 1

Dans cet exemple, la sortie est un document XML, version 1.0. Le mode de codage des caractères est configuré en "ISO-8859-1", la sortie sera indentée pour améliorer la lisibilité :

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" version="1.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

Exemple 2

Dans cet exemple, la sortie est un document HTML, version 4.0. Le mode de codage des caractères est configuré en "ISO-8859-1", la sortie sera indentée pour améliorer la lisibilité :

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" version="4.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

Éléments XSLT