<xsl:output> 項目

指定要用於序列化結果樹狀目錄的選項。

<xsl:output
  method = "xml" | "html" | "text" | QName 
  version = nmtoken 
  encoding = string
  omit-xml-declaration = "yes" | "no"
  standalone = "yes" | "no"
  doctype-public = string 
  doctype-system = string 
  cdata-section-elements = QNames 
  indent = "yes" | "no"
  media-type = string 
  />

屬性

• method
  識別用來輸出結果樹狀結構的整體方法。若沒有前置詞，它會識別此文件中所指定的方法，而此方法必須是 "xml"、"html"、"text" 或非 NCName 之限定名稱 (QName) 其中之一。若有前置詞，則它會展開並識別輸出方法。

  method 屬性的預設值選擇如下。若下列任一條件成立，則預設的輸出方法為 "html"：

  • 結果樹狀結構的根節點具有項目子系。

  • 在結果樹狀結構的根節點中，第一個項目子系 (也就是文件項目) 的展開名稱中含有本機部分 "html" (可任意混用大小寫) 與 Null 的命名空間 URI。

  • 在結果樹狀結構的根節點中，第一個項目子系之前的任何文字節點都只包含泛空白字元。

  否則，預設輸出方法為 "xml"。若沒有 <xsl:output> 項目，或 <xsl:output> 項目皆未指定 method 屬性的值，則應使用預設的輸出方法。

  如果您要輸出 XHTML，將輸出方法設定為 "xml" 而非 "html" 比較有效率。

• version
  指定關於 "xml" 輸出方法的 1.0 版；這在輸出 XML 宣告中會顯示為 <?xml version="1.0"?>。

• encoding
  指定剖析器用來將字元序列編碼為位元組序列的慣用字元編碼。此屬性的值需區分大小寫；它只能包含可列印的 ASCII 字元，且必須為已登錄的字元集，或必須以 x- 開頭。

• omit-xml-declaration
  指定 XSLT 處理器是否應輸出 XML 宣告；其值必須為 yes 或 no。

• standalone
  指定 XSLT 處理器是否應輸出獨立文件宣告；其值必須為 yes 或 no。

• doctype-public
  指定要用於 DTD 中的公用識別項。

• doctype-system
  指定要用於 DTD 中的系統識別項。

• cdata-section-elements
  針對文字節點子系應為使用 CDATA 區段之輸出的項目，指定其 限定名稱 的清單。

• indent
  指定要在輸出結果樹狀結構時新增的其他泛空白字元；其值必須為 yes 或 no。

• media-type
  指定在輸出結果樹狀結構後所產生之資料的媒體型別 (MIME 內容型別)。

項目資訊

發生次數	無限制
父項目	xsl:stylesheet、xsl:transform
項目子系	(沒有項目子系)

備註

樣式表可包含多個 <xsl:output> 項目，也可包含同樣含有 <xsl:output> 項目的樣式表。樣式表中所產生的所有 <xsl:output> 項目，都會合併為單一有效的 <xsl:output> 項目。一個屬性中若有多個這類的值，就會產生錯誤。屬性值的預設值會在 <xsl:output> 項目合併後產生；不同的輸出方法可能會有不同的屬性預設值。

範例

下列主題提供 <xsl:output> 的範例。

• <xsl:output> 的範例 1

• <xsl:output> 的範例 2