XSLT <xsl:output> element

XSLT elementer

Definition og brug

<xsl:output> elementet definerer formatet for outputdokumentet.

Kommentar:<xsl:output> er en topniveau-element (top-level element), og skal være en undernode af <xsl:stylesheet> eller <xsl:transform>.

Syntaks

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

Egenskab

Egenskab Værdi Beskrivelse
method
  • xml
  • html
  • text
  • name
 Valgfri. Definerer outputformatet. Standard er XML. Netscape 6 understøtter kun 'html' og 'xml'.
version string Valgfri. Sæt version-nummeret for outputformatet. Bruges kun, når method="html" eller method="xml".
encoding string Valgfri. Sæt værdien for encoding-attributten i output.
omit-xml-declaration
  • yes
  • no

Valgfri.

"yes" angiver, at XML-deklarationen skal undlades i output (<?xml...?>).

"no" angiver, at der skal inkluderes en XML-deklaration i output. Standard er 'no'.
standalone
    • yes
    • no
 Valgfri. Angiver om XSLT-processoren skal outputte en uafhængig dokumentdeklaration; værdien skal være 'yes' eller 'no'. Standard er 'no'. Netscape 6 understøtter ikke denne egenskab.
doctype-public string Valgfri. Angiver den offentlige identifikator, der skal bruges i DTD'en. Det er værdien for PUBLIC-attributten i DOCTYPE-deklarationen i outputtet.
doctype-system string Valgfri. Angiver den systemidentifikator, der skal bruges i DTD'en. Det er værdien for SYSTEM-attributten i DOCTYPE-deklarationen i outputtet.
cdata-section-elements namelist Valgfri. En mellemrumadskilt elementliste, hvor teksten i elementerne skal uddannes som CDATA-sektioner.
indent
  • yes
  • no
 Valgfri. Angiver om der skal tilføjes blanke tegn til outputresultatet, værdien skal være "yes" eller "no". Netscape 6 understøtter ikke denne egenskab.
media-type string Valgfri. Definerer MIME-typen for output (medietypen for data). Standard er "text/xml". Netscape 6 understøtter ikke denne egenskab.

method-attributten

Identificerer den generelle metode til at udgive resultattreet. Hvis der ikke er et præfiks, skal metoden specificeret i dette dokument være "xml", "html", "text" eller en af de ikke NCName-begrænsede navne. Hvis der er et præfiks, skal det udvikles og identificeres som outputmetode.

Vælgelse af standardværdi for method-attributten ser sådan ud. Hvis nogen af følgende betingelser er sande, er standard outputmetoden "html":

Roden i resultattreet indeholder elementundersub.

Den første elementundersub af roden i resultattreet indeholder det lokale navn "html" (i hvilken som helst kombination af store og små bogstaver) og en tom navnerum URI.

Enhver tekstnode, der findes før den første elementundersub af roden i resultattreet, indeholder kun blanke tegn.

Hvis ikke, er standard outputmetoden "xml". Hvis der ikke er en <xsl:output>-element eller hvis <xsl:output>-element ikke har specificeret en værdi for method-attributten, skal standard outputmetoden bruges.

Eksempel

Eksempel 1

I dette eksemplet er outputtet en XML-dokument, version 1.0. Karakterkodningen er sat til "ISO-8859-1", og outputtet vil blive indrykket for at øge læsbarheden:

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

Eksempel 2

I dette eksemplet er outputtet en HTML-dokument, version 4.0. Karakterkodningen er sat til "ISO-8859-1", og outputtet vil blive indrykket for at øge læsbarheden:

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