XSLT <xsl:output> element

XSLT Element Referentiemanual

Definitie en gebruik

Het <xsl:output> element definieert het formaat van het uitvoerdocument.

Opmerking:<xsl:output> is een top-level element (top-level element), het moet een onderliggend element zijn van <xsl:stylesheet> of <xsl:transform>.

Syntax

<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"/>

Eigenschap

Eigenschap Waarde Beschrijving
method
  • xml
  • html
  • text
  • name
 Optioneel. Definieer de uitvoerindeling. Standaard is XML. Netscape 6 ondersteunt alleen "html" en "xml".
version string Optioneel. Stel het W3C versienummer in voor de uitvoerindeling. (Alleen te gebruiken bij method="html" of method="xml").
encoding string Optioneel. Stelt de waarde van het encoding-attribute in de uitvoer in.
omit-xml-declaration
  • yes
  • no

Optioneel.

"yes" specificeert dat de XML-verklaring moet worden weggelaten in de uitvoer (<?xml...?>).

"no" specificeert dat de XML-verklaring moet worden opgenomen in de uitvoer. Standaard is "no".
standalone
    • yes
    • no
 Optioneel. Specificeert of de XSLT-verwerker een afzonderlijke documentverklaring moet uitvoeren; de waarde moet "yes" of "no" zijn. Standaard is "no". Netscape 6 ondersteunt deze eigenschap niet.
doctype-public string Optioneel. Specificeert het publieke identificator dat in de DTD moet worden gebruikt. Dit is de waarde van het PUBLIC-attribute van de DOCTYPE-aanwijzing in de uitvoer.
doctype-system string Optioneel. Specificeert het systeemidentificator dat in de DTD moet worden gebruikt. Dit is de waarde van het SYSTEM-attribute van de DOCTYPE-aanwijzing in de uitvoer.
cdata-section-elements namelist Optioneel. Een door spaties gescheiden lijst van elementen, waarvan de tekstinhoud als CDATA-sectie moet worden uitgevoerd.
indent
  • yes
  • no
 Optioneel. Specificeert of witruimte moet worden toegevoegd bij het uitvoeren van het resultaatboomstructuur; de waarde moet "yes" of "no" zijn. Netscape 6 ondersteunt deze eigenschap niet.
media-type string Optioneel. Definieert het MIME-type van de uitvoer (de media-type van de gegevens). Standaard is "text/xml". Netscape 6 ondersteunt deze eigenschap niet.

property attribute

Identificeert het gebruikte algemene methoden voor het uitvoeren van het resultaatboomstructuur. Als er geen voorvoegsel is, wordt de methode die in dit document is gespecificeerd aangeduid, deze moet "xml", "html", "text" of een van de niet-NCName beperkte namen zijn). Als er een voorvoegsel is, wordt dit uitgebreid en wordt de uitvoermethode aangeduid.

De keuze van de standaardwaarde van de property attribute is weergegeven hieronder. Als een van de volgende voorwaarden waar is, is de standaard uitvoermethode "html":

De wortelknoot van het resultaatboomstructuur bevat elementonderliggende.

De uitbreiding van de eerste elementonderliggende van de wortelknoot in het resultaatboomstructuur bevat de lokale deelnaam "html" (enkele combinatie van hoofdletters en kleine letters) en een lege naamruimte URI.

Elke tekstknoot voor de eerste elementonderliggende van de wortelknoot in het resultaatboomstructuur bevat alleen witruimte.

Andersom is de standaard uitvoermethode "xml". Als er geen <xsl:output>-element is of als het <xsl:output>-element de waarde van de property attribute niet heeft gespecificeerd, moet de standaard uitvoermethode worden gebruikt.

Voorbeeld

Voorbeeld 1

In dit voorbeeld is de uitvoer een XML-document, versie 1.0. Het karaktersets wordt ingesteld op "ISO-8859-1", de uitvoer wordt ingesprongen om de leesbaarheid te verbeteren:

<?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>

Voorbeeld 2

In dit voorbeeld is de uitvoer een HTML-document, versie 4.0. Het karakterset wordt ingesteld op "ISO-8859-1", de uitvoer wordt ingesprongen om leesbaarheid te verbeteren:

<?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>

XSLT Element Referentiemanual