Élément <xsl:output>

Spécifie les options à utiliser dans la sérialisation de l'arborescence résultat.

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

Attributs

• method
  Identifie la méthode globale utilisée pour la sortie de l'arborescence résultat. S'il n'y a pas de préfixe, cet attribut identifie une méthode spécifiée dans ce document qui doit être « xml », « html », « text » ou un nom qualifié (QName) qui n'est pas un NCName. S'il y a un préfixe, il est développé et identifie la méthode de sortie.

  La valeur par défaut de l'attribut method est sélectionnée comme suit. Si une des conditions suivantes est vérifiée, la méthode de sortie par défaut est « html » :

  • Le nœud racine de l'arborescence résultat a un élément enfant.

  • Le nom développé du premier élément enfant du nœud racine (donc, de l'élément de document) de l'arborescence résultat présente une partie locale « html » (dans toute combinaison de majuscules et minuscules) et un URI d'espace de noms égal à null.

  • Tous les nœuds de texte précédant le premier élément enfant du nœud racine de l'arborescence résultat ne contiennent que des espaces blancs.

  Dans les autres cas, la méthode de sortie par défaut est « xml ». Utilisez la méthode de sortie par défaut s'il n'y a pas d'éléments <xsl:output> ou si aucun des éléments <xsl:output> ne spécifie une valeur pour l'attribut method.

  Si vous effectuez une sortie XHTML, il est plus efficace de définir la méthode de sortie sur « xml » que sur « html ».

• version
  Spécifie la version 1.0 en relation avec la méthode de sortie « xml » ; ceci apparaît dans la déclaration XML de sortie comme <?xml version="1.0"?>.

• encoding
  Spécifie la méthode favorite d'encodage des caractères que l'analyseur doit utiliser pour coder des séquences de caractères comme des séquences d'octets. La valeur de l'attribut est traitée sans tenir compte de la casse ; elle ne peut contenir que des caractères ASCII imprimables et doit être un jeu de caractères enregistré ou commencer par x-.

• omit-xml-declaration
  Spécifie si le processeur XSLT doit générer une déclaration XML ; la valeur doit être yes ou no.

• standalone
  Spécifie si le processeur XSLT doit générer une déclaration de document autonome ; la valeur doit être yes ou no.

• doctype-public
  Spécifie l'identificateur public à utiliser dans la DTD.

• doctype-system
  Spécifie l'identificateur système à utiliser dans la DTD.

• cdata-section-elements
  Spécifie une liste de Noms qualifiés des éléments dont les nœuds de texte enfants doivent être insérés dans la sortie à l'aide de sections CDATA.

• indent
  Spécifie les espaces blancs supplémentaires à ajouter lors de la sortie de l'arborescence résultat ; la valeur doit être yes ou no.

• media-type
  Spécifie le type de média (type de contenu MIME) des données résultant de la sortie de l'arborescence résultat.

Informations sur l'élément

Notes

Une feuille de style peut contenir plusieurs éléments <xsl:output> et inclure des feuilles de style contenant également des éléments <xsl:output>. Tous les éléments <xsl:output> figurant dans une feuille de style sont fusionnés en un seul élément <xsl:output> effectif. Une erreur survient s'il existe plusieurs valeurs de ce type pour un attribut. Les attributs reçoivent une valeur par défaut après la fusion des éléments <xsl:output> ; différentes méthodes de sortie peuvent utiliser des valeurs par défaut différentes pour un même attribut.

Exemples

Les rubriques suivantes fournissent des exemples de <xsl:output>.

• Exemple 1 de <xsl:output>

• Exemple 2 de <xsl:output>