XSLT <xsl:output> element

XSLT element referencehåndbog

Definering og brug

<xsl:output> elementet definerer formatet for outputdokumentet.

Kommentar:<xsl:output> er en topniveau-element (top-level element), og skal være en underkomponent 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. Definer outputformat. Standard er XML. Netscape 6 understøtter kun "html" og "xml".
version string Valgfri. Angiv W3C-versionnummer for outputformat. (Kun brugt når method="html" eller method="xml").
encoding string Valgfri. Angiver værdien af encoding-attributten i output.
omit-xml-declaration
  • yes
  • no

Valgfri.

"yes" bestemmer, at der skal udelades en XML-deklaration (<?xml...?>) i output.

"no" bestemmer, at der skal inkluderes en XML-deklaration i output. Standard er "no".
standalone
    • yes
    • no
 Valgfri. Angiver om XSLT-håndtereren skal outputte en standalone 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. Altså værdien af PUBLIC-attributten i DOCTYPE-deklarationen i output.
doctype-system string Valgfri. Angiver den systemidentifikator, der skal bruges i DTD'en. Altså værdien af SYSTEM-attributten i DOCTYPE-deklarationen i output.
cdata-section-elements namelist Valgfri. En mellemrumadskilt elementliste, hvor teksten i elementerne skal outputtes som CDATA-sektioner.
indent
  • yes
  • no
 Valgfri. Angiver om der skal tilføjes blanke mellemrum i outputresultattreet; værdien skal være "yes" eller "no". Netscape 6 understøtter ikke denne egenskab.
media-type string Valgfri. Definerer outputets MIME-type (datamedietypen). Standard er "text/xml". Netscape 6 understøtter ikke denne egenskab.

method-attributten

Identificerer den metode, der bruges til at output resultattreet. Hvis der ikke er et præfiks, skal metoden, der er 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 output-metoden.

Vælgelse af standardværdi for method-attributten fremgår af følgende. Hvis nogen af følgende betingelser er sande, er standard output-metoden "html":

Roden i resultattreet indeholder elementunderordnede.

Den første elementunderordnet af roden i resultattreet (dvs. dokumentelementet) indeholder en udvidelsesnavn, der indeholder den lokale del "html" (i hvilken som helst kombination af store og små bogstaver) og en tom navnerum URI.

Enhver tekstnode, der er foran den første elementunderordnet af roden i resultattreet, indeholder kun blanke tegn.

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

Eksempel

Eksempel 1

I dette eksempel er output en XML-dokument, version 1.0. Karakterkodningens metode er sat til "ISO-8859-1", og output vil blive indrykket for at forbedre 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 eksempel er outputtet et HTML-dokument, versionen er 4.0. Karakterkodingen er sat til "ISO-8859-1", outputtet vil blive indrykket for at forbedre 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 element referencehåndbog