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