<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”（任意大小写组合）和空命名空间 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