XSLT <xsl:output>-elementet

Definition och användning

<xsl:output>-elementet definierar formatet för utdata-dokumentet.

Kommentar:<xsl:output> är en toppnivåelement (top-level element), måste vara en undernod till <xsl:stylesheet> eller <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"/>

Egenskap

Egenskap Värde Beskrivning
method
  • xml
  • html
  • text
  • name
Valfritt. Definiera utdataformatet. Standard är XML. Netscape 6 stöder endast "html" och "xml".
version string Valfritt. Ställ in versionnumret för W3C-formaten. Används endast när method="html" eller method="xml".
encoding string Valfritt. Ställ in värdet för koderhetsattributet i utdata.
omit-xml-declaration
  • yes
  • no

Valfritt.

"yes" bestämmer att en XML-förklaring ska utelämnas i utdata (<?xml...?>).

"no" bestämmer att en XML-förklaring ska inkluderas i utdata. Standard är "no".

standalone
    • yes
    • no
Valfritt. Bestämmer om XSLT-processorn ska skriva ut en separat dokumentförklaring; värdet måste vara yes eller no. Standard är "no". Netscape 6 stöder inte denna egenskap.
doctype-public string Valfritt. Specificera den allmänna identifieraren som ska användas i DTD:n. Detta är värdet för PUBLIC-attributet i DOCTYPE-deklarationen i utmatningen.
doctype-system string Valfritt. Specificera den systemidentifierare som ska användas i DTD:n. Detta är värdet för SYSTEM-attributet i DOCTYPE-deklarationen i utmatningen.
cdata-section-elements namelist Valfritt. En lista med element separerade av mellanslag, där textinnehållet bör utges som CDATA-sektion.
indent
  • yes
  • no
Valfritt. Ange om det ska läggas till blanka tecken vid utmatningen av resultatträdet; värdet måste vara "yes" eller "no". Netscape 6 stöder inte detta attribut.
media-type string Valfritt. Definiera den MIME-typ som används för utmatningen (dataens mediatyp). Standard är "text/xml". Netscape 6 stöder inte detta attribut.

method-attribut

Identifikation av den generella metod som används för att utge resultatträdet. Om det inte finns någon prefix, betyder detta att metoden som specificeras i dokumentet måste vara "xml", "html", "text" eller någon annan inte är NCName begränsad namn. Om det finns ett prefix, expanderas och identifieras utmatningsmetoden.

Valet av standardvärde för method-attributet visas nedan. Om någon av följande villkor är sanna, är den standardiserade utmatningsmetoden "html":

Roden i resultatträdet innehåller elementundersubnivåer.

Den ursprungliga noden i resultatträdet innehåller elementundersubnivåer. Den utökade namnet på den första elementundersubnivån (dvs. dokumentelementet) innehåller den lokala delen "html" (alla storlekskombinationer) och en tom namnrymd URI.

Alla textnoder innan den första elementundersubnivån till rodnoden i resultatträdet innehåller endast blanka tecken.

Annars är den standardiserade utmatningsmetoden "xml". Om det inte finns någon <xsl:output>-element eller om <xsl:output>-elementet inte har specificerat ett värde för method-attributet, bör den standardiserade utmatningsmetoden användas.

Exempel

Exempel 1

I detta exempel är utmatningen en XML-dokument, version 1.0. Karaktersnittsättningen är satt till "ISO-8859-1", utmatningen kommer att indenteras för att förbättra läsbarheten:

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

Exempel 2

I detta exempel är utmatningen en HTML-dokument, version 4.0. Karaktersnittsättningen är satt till "ISO-8859-1", utmatningen kommer att indenteras för att förbättra läsbarheten:

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