XSLT <xsl:output> element

XSLT Elementen

Definitie en gebruik

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

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

Syntaxis

<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 het formaat van de uitvoer. Standaard is XML. Netscape 6 ondersteunt alleen "html" en "xml".
version string Optioneel. Stel de versie van de W3C van het uitvoerformaat in. (Alleen gebruikt bij method="html" of method="xml".).
encoding string Optioneel. Stel de waarde van het encoding-eigenschap in voor de uitvoer.
omit-xml-declaration
  • yes
  • no

Optioneel.

"yes" bepaalt dat de XML-verklaring wordt weggelaten in de uitvoer (<?xml...?>).

"no" bepaalt dat er een XML-verklaring moet worden opgenomen in de uitvoer. Standaard is dit "no".
standalone
    • yes
    • no
 Optioneel. Stelt in of de XSLT-verwerker een onafhankelijke documentverklaring moet uitvoeren; deze waarde moet yes of no zijn. Standaard is dit "no". Netscape 6 ondersteunt deze eigenschap niet.
doctype-public string Optioneel. Specificeert het publieke identificator dat moet worden gebruikt in de DTD. Dit is de waarde van het PUBLIC-attribuut van de DOCTYPE-declaratie in de output.
doctype-system string Optioneel. Specificeert het systeemidentificator dat moet worden gebruikt in de DTD. Dit is de waarde van het SYSTEM-attribuut van de DOCTYPE-declaratie in de output.
cdata-section-elements namelist Optioneel. Een door spaties gescheiden lijst van elementen, waarvan de tekstinhoud als CDATA-gedeelte moet worden output.
indent
  • yes
  • no
 Optioneel. Specificeert of witte ruimte moet worden toegevoegd bij het outputten van het resultaatboomstructuur; de waarde moet "yes" of "no" zijn. Netscape 6 ondersteunt deze property niet.
media-type string Optioneel. Definieert de MIME-type van de uitvoer (de media-type van de gegevens). Standaard is "text/xml". Netscape 6 ondersteunt deze property niet.

property 'method'

Identificeert het gebruikte overkoepelende methoden voor het outputten van het resultaatboomstructuur. Als er geen voorvoegsel is, wordt de methode die in dit document is gespecificeerd geïdentificeerd, en moet dit "xml", "html", "text" of een van de niet-NCName-bepaalde namen zijn). Als er een voorvoegsel is, wordt dit uitgebreid en wordt de outputmethode geïdentificeerd.

De keuze van de standaardwaarde van de property 'method' is als volgt weergegeven. Als een van de volgende voorwaarden waar is, is de standaard uitvoermethode "html":

De wortel van het resultaatboomstructuur bevat elementonderliggende.

De uitbreiding van de eerste elementonderliggende van de wortel van het resultaatboomstructuur bevat de lokale deelnaam "html" (enkele willekeurige combinatie van hoofd- en kleine letters) en een lege naamruimte URI.

Elke tekstnode voor de eerste elementonderliggende van de wortel van het resultaatboomstructuur bevat alleen witte regels.

Als dat niet het geval is, is de standaard uitvoermethode "xml". Als er geen <xsl:output>-element is of als het <xsl:output>-element geen waarde voor de property 'method' heeft gespecificeerd, moet de standaard uitvoermethode worden gebruikt.

Voorbeeld

Voorbeeld 1

In dit voorbeeld is de uitvoer een XML-document, versie 1.0. De karakterset is 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="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. De karakterset is 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 Elementen