XSLT <xsl:output> 元素

XSLT 元素

定義和用法

<xsl:output> 元素定義了輸出文檔的格式。

註釋：<xsl:output> 是頂層元素（top-level element），必須是 <xsl:stylesheet> 或 <xsl:transform> 的子節點。

語法

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

屬性

屬性 值 描述
method
  • xml
  • html
  • text
  • name
 可选。定義輸出的格式。默認是 XML。Netscape 6 僅支持 "html" 和 "xml"。
version string 可选。設置輸出格式的 W3C 版本號。（僅在 method="html" 或 method="xml" 時使用）。
encoding string 可选。設置輸出中編碼屬性的值。
omit-xml-declaration
  • yes
  • no

可选。

"yes" 規定在輸出中省略 XML 聲明 (<?xml...?>)。

"no" 規定應在輸出中包含 XML 聲明。默認是 "no"。
standalone
    • yes
    • no
 可选。規定 XSLT 處理器是否應輸出獨立文檔聲明；該值必須為 yes 或 no。默認是 "no"。Netscape 6 不支持該屬性。
doctype-public string Opisyal. Tukuyin ang public identifier na gagamitin sa DTD. Ito ay ang halaga ng attribute na PUBLIC ng DOCTYPE sa labas.
doctype-system string Opisyal. Tukuyin ang system identifier na gagamitin sa DTD. Ito ay ang halaga ng attribute na SYSTEM ng DOCTYPE sa labas.
cdata-section-elements namelist Opisyal. Isang liistang nakaapilya ng espasyo ng elementong dapat ay magiging CDATA bahagi sa labas.
indent
  • yes
  • no
 Opisyal. Ang kung kailangan o hindi magdagdag ng walang laman sa labas ng resulta ng tree; ang halaga ay dapat ay yes o no. Hindi suportado ng Netscape 6 ang attribute na ito.
media-type string Opisyal. Idefinir ang MIME type ng labas (ang media type ng datos). Ang default ay "text/xml". Hindi suportado ng Netscape 6 ang attribute na ito.

Attribute na method

Ang pagkilala ng pangkalahatang paraan ng paglabas ng resulta ng tree. Kung walang prefix, pagkilala ang paraan na tinukoy ng dokumento, dapat ay "xml", "html", "text" o isa sa mga hindi naaayon sa NCName. Kung mayroon ng prefix, ipalapain at pagkilala ang paraan ng labas.

Ang pagpili ng default na halaga ng attribute na method ay tulad sa ibabang-ita. Kung anumang sa mga sumusunod na kondisyon ay tunay, ang default na paraan ng labas ay "html":

Ang pangunahing elemento ng resulta ng tree ay naglalaman ng pangalawang elemento.

Ang pangunahing elemento ng resulta ng tree ay naglalaman ng pangalawang elemento na may pangalawang bahagi na may lokal na bahagi na "html" (anumang kombinasyon ng kapistahan ng may kapit) at walang uri ng pangalan ng namespace.

Ang anumang text na elemento bago ang unang anak ng pangunahing elemento ng resulta ng tree ay naglalaman lamang ng walang laman na character.

Kung wala ang piniling paraan ng labas, ang default na paraan ng labas ay "xml". Kung walang <xsl:output> elemento o walang <xsl:output> elemento na nagbigay ng halaga ng attribute na method, dapat gamitin ang default na paraan ng labas.

Mga halimbawa

Halimbawa 1

Sa halimbawa na ito, ang labas ay XML dokumento, ang bersyon ay 1.0. Ang paraan ng pagsasalita ng character encoding ay na-set sa "ISO-8859-1", ang labas ay magiging maikling lagay upang mapabuti ang pagbabasa:

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

Halimbawa 2

Sa halimbawa na ito, ang labas ay HTML dokumento, ang bersyon ay 4.0. Ang paraan ng pagsasalita ng character encoding ay na-set sa "ISO-8859-1", ang labas ay magiging maikling lagay upang mapabuti ang pagbabasa:

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