XSLT <xsl:output> -elementti

XSLT elementtien viittaushakemisto

Määrittely ja käyttö

<xsl:output> -elementti määrittää tulostustiedoston muodon.

Huomautus:<xsl:output> on ylätaso (top-level) elementti, ja sen on oltava <xsl:stylesheet> tai <xsl:transform> -elementin lapsi.

syntaksi

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

ominaisuus

ominaisuus arvo kuvaus
method
  • xml
  • html
  • text
  • name
 Valinnainen. Määritä tulostusmuoto. Oletus on XML. Netscape 6 tukee vain "html" ja "xml".
version string Valinnainen. Määritä tulostusmuodon W3C-versioiden numero. (Käytetään vain, kun method="html" tai method="xml").
encoding string Valinnainen. Asettaa arvon output-ominaisuudelle.
omit-xml-declaration
  • yes
  • no

Valinnainen

"yes" määrittää, että tulostukseen tulisi jättää XML-deklarointi pois (<?xml...?>).

"no" määrittää, että tulostukseen tulisi sisällyttää XML-deklarointi. Oletusarvo on "no".
standalone
    • yes
    • no
 Valinnainen. Määrittää, tulisiko XSLT-käsittelijän tulostaa itsenäisen asiakirja julistuksen; arvon on oltava yes tai no. Oletusarvo on "no". Netscape 6 ei tue tätä ominaisuutta.
doctype-public string Valinnainen. Määrittää DTD:ssä käytettävän julkisen tunnisteen. Tämä on DOCTYPE-deklaroinnin PUBLIC-ominaisuuden arvo tulostuksessa.
doctype-system string Valinnainen. Määrittää DTD:ssä käytettävän järjestelmä tunnisteen. Tämä on DOCTYPE-deklaroinnin SYSTEM-ominaisuuden arvo tulostuksessa.
cdata-section-elements namelist Valinnainen. Tyhjillä välilyönneillä erotettu elementtilista, joiden tekstisisältö tulostetaan CDATA-osana.
indent
  • yes
  • no
 Valinnainen. Määrittää, halutaanko lisätä välilyönnit tulostustuunin tulokseen; arvon on oltava yes tai no. Netscape 6 ei tue tätä ominaisuutta.
media-type string Valinnainen. Määrittää tulostuksen MIME-tyypin (datan median tyyppi). Oletusarvo on "text/xml". Netscape 6 ei tue tätä ominaisuutta.

method-ominaisuus

Tunnisteet, jotka tunnistavat tulostustuunin yleisen tulostusmenetelmän. Jos et ole määritetty etuliitettä, tunniste tässä asiakirjassa määritetty menetelmä, joka on "xml", "html", "text" tai ei ole NCName-rajoitettu nimi. Jos et ole määritetty etuliitettä, laajennetaan ja tunnistetaan tulostusmenetelmä.

Method-ominaisuuden oletusarvojen valinta näkyy seuraavasti. Jos seuraavista ehdoista jokin on totta, oletusarvoinen tulostusmenetelmä on "html":

Tulostustuunin juurin sisältää elementin alikomponentin.

Tulostustuunin juurin ensimmäisen elementin alikomponentin (eli asiakirja-elementin) laajennusnimi sisältää paikallisen osan "html" (mikä tahansa isojen ja pienien kirjainten yhdistelmä) ja tyhjän nimen URI:n.

Tulostustuunin juurin ensimmäisen elementin alikomponentin edellä olevat kaikki tekstinodeitit sisältävät vain tyhjiä merkkejä.

Muuten oletusarvoinen tulostusmenetelmä on "xml". Jos ei ole <xsl:output>-elementtiä tai jos <xsl:output>-elementti ei määrittele method-ominaisuuden arvoa, tulisi käyttää oletusarvoista tulostusmenetelmää.

Esimerkki

Esimerkki 1

Tässä esimerkissä tulostus on XML-dokumentti, versio 1.0. Merkkikoodausmuoto on asetettu "ISO-8859-1". Tulostus tehdään sisennettynä parantaakseen luettavuutta:

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

Esimerkki 2

Tässä esimerkissä tulostus on HTML-dokumentti, versio on 4.0. Merkkikoodaus on asetettu "ISO-8859-1":ksi, ja tulostus tehdään sisennettynä parantaakseen luettavuutta:

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