XSLT如何输出不同格式文档？-XML/RSS教程-PHP中文网

XSLT通过xsl:output的method属性控制输出格式，可生成HTML、XML、文本、XSL-FO等，结合FO处理器生成PDF，XSLT 3.0支持JSON输出，CSV需文本模式手动构造，Office文档通常间接生成。

xslt如何输出不同格式文档？

XSLT，全称可扩展样式表语言转换，它的核心能力在于将一份XML文档转换为另一份文档。这个“另一份文档”可以是任何基于文本的格式，最常见的是HTML，但它也能生成纯文本、其他XML方言（如SVG、RSS），甚至通过中间步骤生成PDF或Office文档。理解XSLT的强大之处，在于它并非直接“画”出这些文档，而是构建它们的文本结构或指令集。

解决方案

XSLT输出不同格式文档的秘密，主要藏在

xsl:output

登录后复制

元素及其

method

登录后复制

属性里。这个属性告诉XSLT处理器，你希望最终的输出结果以何种方式被序列化。

最直接的当然是XML到XML的转换，这是XSLT的本职工作。你可以将一个复杂的XML数据结构，转换成另一个更简洁、更适合特定用途的XML结构。比如，从一个通用数据格式转换成一个特定应用程序的配置XML。

当我们需要生成网页内容时，

method=&amp;quot;html&amp;quot;

登录后复制

就派上用场了。XSLT会智能地处理HTML特有的空标签（如

<br>

登录后复制

、

<img>

登录后复制

），并确保输出的HTML是浏览器友好的。它不会像处理通用XML那样，强制所有标签都必须闭合，这让生成的HTML更符合标准。

如果目标是纯文本，比如CSV文件、日志文件，或者某种自定义的脚本，那么

method=&amp;quot;text&amp;quot;

登录后复制

是你的选择。在这种模式下，XSLT会尽可能地去除所有标签，只输出你模板中定义的文本内容，并严格按照你的

xsl:text

登录后复制

或直接文本内容来排版。

而对于那些需要复杂排版、打印输出的文档，比如PDF、打印报告，XSLT通常不会直接生成它们。它会生成一个中间格式——XSL-FO（XSL Formatting Objects）。XSL-FO本身也是一种XML文档，它描述了文档的布局、字体、颜色、分页等所有排版细节。生成XSL-FO后，你需要一个专门的FO处理器（比如Apache FOP、RenderX XEP等）来将这个FO文档渲染成最终的PDF、RTF或其他打印格式。这是一个两阶段的过程，但非常强大和灵活。

至于JSON、CSV或Office文档，XSLT也能处理，但方式略有不同，有些需要更高级的XSLT版本或更巧妙的构造。

XSLT生成HTML的常见实践与注意事项

XSLT生成HTML，这几乎是它最普及的应用场景之一。我个人觉得，它在构建静态网站或动态网页的局部内容时，效率和可维护性都非常高。

核心在于使用

xsl:output method=&amp;quot;html&amp;quot;

登录后复制

。一旦你声明了这个，XSLT处理器就会明白你的意图，它会：

自动处理HTML的空元素，比如
```
<br/>
```
登录后复制
会被输出为
```
<br>
```
登录后复制
。
对特殊字符进行适当的实体编码，确保浏览器正确解析，例如
```
&amp;
```
登录后复制
会被转义为
```
&amp;
```
登录后复制
。
默认情况下，它还会尝试生成一个符合HTML规范的文档结构。

实践中，你通常会这样做：

定义HTML骨架： 在你的XSLT根模板中，直接写出HTML的基本结构，如
```
<html><head>...</head><body>...</body></html>
```
登录后复制
。
动态插入内容： 使用
```
xsl:apply-templates
```
登录后复制
或
```
xsl:value-of
```
登录后复制
来从源XML中提取数据，并将其插入到HTML的相应位置。
条件判断与循环： 利用
```
xsl:if
```
登录后复制
、
```
xsl:choose
```
登录后复制
和
```
xsl:for-each
```
登录后复制
来根据XML数据动态生成不同的HTML片段或重复的列表项。

但也有一些需要注意的地方：

命名空间冲突： 如果你的源XML中包含默认命名空间，而你在XSLT中直接写HTML标签，可能会遇到匹配问题。通常的做法是在XSLT中声明源XML的命名空间，并在匹配模板时使用前缀。
HTML5的新特性： 确保你的XSLT处理器支持HTML5的输出，或者你手动控制输出的DOCTYPE。老旧的处理器可能默认生成XHTML或HTML4。
CSS和JavaScript的集成： 这些通常作为静态资源在HTML中引用。XSLT只负责生成HTML结构，不直接处理CSS或JS的逻辑。你可以用XSLT动态生成CSS类名或JS变量，但复杂的交互逻辑还是在客户端处理。
调试： 生成的HTML有时会因为XSLT逻辑错误而变得混乱。利用浏览器的开发者工具检查DOM结构和错误信息，是定位问题的有效方法。

总体来说，XSLT生成HTML是一个成熟且高效的方案，尤其适合数据驱动的网页内容生成。

Calliper 文档对比神器

文档内容对比神器

查看详情

利用XSLT结合XSL-FO生成高质量PDF文档的流程

当我第一次接触XSL-FO的时候，我感觉它就像是用XML在“编程”排版。它确实复杂，但一旦掌握，那种对文档布局的精细控制能力是无与伦比的，特别适合生成报告、发票、合同这类需要严格格式的文档。

基本流程是这样的：

XSLT转换到XSL-FO： 这是第一步，也是XSLT发挥作用的地方。你编写一个XSLT样式表，其目标不是直接生成PDF，而是生成一个遵循XSL-FO规范的XML文档。这个XSL-FO文档会详细描述页面大小、页边距、字体、段落、表格、图片位置等等所有排版细节。
- 你需要使用
```
xsl:output method="xml"
```
  登录后复制
  ，因为XSL-FO本身就是XML。
- 在XSLT中，你会用到大量的XSL-FO元素，比如
```
<fo:root>
```
  登录后复制
  、
```
<fo:layout-master-set>
```
  登录后复制
  、
```
<fo:page-sequence>
```
  登录后复制
  、
```
<fo:flow>
```
  登录后复制
  、
```
<fo:block>
```
  登录后复制
  、
```
<fo:table>
```
  登录后复制
  等等。这些元素对应着排版中的各种概念。
- 例如，你可能有一个模板，将XML中的
```
<product>
```
  登录后复制
  数据转换为XSL-FO中的
```
<fo:table-row>
```
  登录后复制
  和
```
<fo:table-cell>
```
  登录后复制
  ，以构建一个产品列表。
XSL-FO处理器渲染PDF： 得到了XSL-FO文档后，你需要一个专门的XSL-FO处理器来将其解析并渲染成最终的PDF文件。
- Apache FOP 是一个非常流行的开源选择，它基于Java，功能强大，支持大部分XSL-FO 1.1规范。
- RenderX XEP 和 Antenna House Formatter 是商业产品，通常提供更全面的XSL-FO支持和更高级的排版功能，尤其在字体处理、复杂布局方面表现更优。

这个过程的优势在于：

内容与样式分离： 你的原始XML数据是内容，XSLT样式表定义了如何将内容映射到排版结构，XSL-FO则承载了最终的排版指令。这种分离使得内容的更新和样式的修改互不影响。
高度可定制： XSL-FO提供了对文档排版几乎所有方面的控制，从微观的字符间距到宏观的页面布局，都能精确定义。
自动化生成： 一旦XSLT样式表和XSL-FO处理器设置好，就可以实现大规模、自动化的PDF报告生成，这在企业级应用中非常常见。

挑战也不少：

学习曲线陡峭： XSL-FO规范本身非常庞大和复杂，需要投入大量时间学习。
调试困难： XSLT转换错误或XSL-FO结构不正确，都可能导致PDF渲染失败或布局异常。调试XSL-FO文档通常需要反复修改XSLT并重新渲染。
处理器兼容性： 不同的XSL-FO处理器对规范的支持程度不一，某些高级特性可能在一个处理器上工作，在另一个上则不行。

尽管有这些挑战，但对于需要高质量、可编程控制的PDF输出场景，XSLT + XSL-FO依然是工业界的首选方案之一。

XSLT直接生成JSON、CSV或Office文档的局限与策略

XSLT在处理JSON、CSV和Office文档时，情况就变得多样化了，有些是直接支持，有些则需要“曲线救国”。

生成JSON： 在XSLT 1.0时代，直接生成JSON是一个痛苦的过程。因为JSON本质上是一种键值对和数组的文本表示，XSLT 1.0没有内置的JSON构建函数，你只能通过拼接字符串的方式来构造JSON结构。这不仅繁琐，而且极易出错，特别是当数据中包含需要转义的特殊字符时。不过，随着XSLT 3.0的到来，情况发生了根本性变化。XSLT 3.0引入了对JSON的直接支持，你可以使用

map

登录后复制

和

array

登录后复制

函数来构建JSON对象和数组，并配合

json:serialize

登录后复制

或

xsl:output method="json"

登录后复制

直接输出标准的JSON格式。这大大简化了从XML到JSON的转换，使其变得安全且高效。如果你还在使用XSLT 2.0，一些处理器（如Saxon）也提供了扩展函数来辅助JSON生成，但不如XSLT 3.0原生支持那样优雅。

生成CSV： 生成CSV（Comma Separated Values）文件相对简单，主要依赖于

xsl:output method=&amp;quot;text&amp;quot;

登录后复制

。

策略： 你需要遍历XML数据，然后使用
```
xsl:value-of
```
登录后复制
提取每个字段的值，并在它们之间插入逗号（或其他分隔符）。每行数据结束后，输出一个换行符。
挑战： 最大的挑战在于数据中可能包含逗号、双引号或换行符。根据CSV规范，这些特殊字符需要用双引号包围，并且双引号本身在数据中出现时需要用两个双引号来转义。你的XSLT模板必须小心处理这些转义逻辑，否则生成的CSV文件可能无法被正确解析。

例子：

<data>
  <record>
    <field1>Value A</field1>
    <field2>Value B, with comma</field2>
  </record>
  <record>
    <field1>Value C</field1>
    <field2>Value D</field2>
  </record>
</data>

登录后复制

对应的XSLT可能需要一个函数或复杂逻辑来处理

field2

登录后复制

中的逗号和双引号。

生成Office文档（DOCX, XLSX）： 这通常不是XSLT的直接强项，因为它不像HTML或XSL-FO那样有直接的输出方法。Word和Excel现代文档格式（

.docx

登录后复制

和

.xlsx

登录后复制

）实际上是基于Office Open XML (OOXML) 规范的ZIP压缩包，里面包含了一系列XML文件来描述文档结构、内容、样式等。

策略： 理论上，你可以用XSLT生成这些OOXML文件。这意味着你的XSLT需要非常深入地理解OOXML规范，知道如何构造
```
document.xml
```
登录后复制
、
```
styles.xml
```
登录后复制
、
```
workbook.xml
```
登录后复制
等文件，并将它们打包成一个ZIP文件。
局限： 这种方法极其复杂和繁琐。OOXML规范庞大，细节繁多，手动用XSLT构造这些XML文件的工作量巨大，且维护困难。一个小小的格式错误都可能导致Office软件无法打开文档。
替代方案： 现实中，更常见的做法是：
1. 模板法： 创建一个包含占位符的Word或Excel模板，然后用其他编程语言（如Java、Python）读取XML数据，填充这些占位符，生成最终文档。
2. 专用库： 使用像Apache POI (Java) 或 OpenPyXL (Python) 这样的库，它们提供了高级API来操作Office文档，隐藏了OOXML的底层复杂性。
3. XSLT生成中间XML，再转换： XSLT可以生成一个自定义的、简洁的XML格式，这个XML再作为输入，由其他工具或脚本转换为OOXML。