valinnainen kurssi

XSLT elementit

kurssivihje:

XSLT <xsl:output> -elementti

määrittely ja käyttöhuomautus:

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äärittää tulosteen muodon. Oletusarvo on XML. Netscape 6 tukee vain "html" ja "xml".
version string Valinnainen. Asettaa tulosteen muodon W3C-versioarvon. (Käytetään vain method="html" tai method="xml" -tilanteissa).
encoding string Valinnainen. Asettaa koodauksen arvon tulosteessa.
omit-xml-declaration
  • yes
  • no

Valinnainen

"yes" määrittää, että XML-ilmu tulisi olla jätetty pois tulosteessa (<?xml...?>).

"no" määrittää, että XML-ilmun tulisi olla mukana tulosteessa. Oletusarvo on "no".
standalone
    • yes
    • no
 Valinnainen. Määrittää, tulisiko XSLT-käsittelylaitteen tulostaa itsenäisen asiakirja-ilmun; arvon täytyy olla 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 tulostuksessa olevan DOCTYPE-deklaroinnin PUBLIC-ominaisuuden arvo.
doctype-system string Valinnainen. Määrittää DTD:ssä käytettävän järjestelmän tunnisteen. Tämä on tulostuksessa olevan DOCTYPE-deklaroinnin SYSTEM-ominaisuuden arvo.
cdata-section-elements namelist Valinnainen. Tyhjillä välilyönneillä erotettu elementtilista, joiden tekstin tulisi olla CDATA-osana tulostettuna.
indent
  • yes
  • no
 Valinnainen. Määrittää, lisätäänkö tyhjiä merkkejä tulostettavaan tulostustuohon. Arvon täytyy olla "yes" tai "no". Netscape 6 ei tue tätä ominaisuutta.
media-type string Valinnainen. Määrittää tulostuksen MIME-tyypin (datan median tyyppi). Oletus on "text/xml". Netscape 6 ei tue tätä ominaisuutta.

method-ominaisuus

Tunnisteet, jotka käytetään tulostustuon yleisen tulostustavan määrittämiseen. Jos et ole määritetty etuliitettä, tunniste viittaa tässä dokumentissa määritettyyn menetelmään, ja täytyy olla "xml", "html", "text" tai minkään NCName:n määrittelyn nimi.

method-ominaisuuden oletusarvon valinta näkyy seuraavasti. Jos seuraavista ehdoista on totta, oletusarvoinen tulostustapa on "html":

Tulostustuon juuren sisältää elementin alikomponentin.

Tulostustuon juuren ensimmäisen elementin ensimmäisen alikomponentin (eli dokumenttielementin) laajennusnimi sisältää paikallisen osan "html" (mikä tahansa isojen ja pienien kirjainten yhdistelmä) ja tyhjän nimenkerroksen URI.

Tulostustuon juuren ensimmäisen elementin ensimmäisen alikomponentin edellä olevat kaikki tekstinodet sisältävät vain tyhjiä merkkejä.

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

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 4.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="html" version="4.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

XSLT elementit