XSLT模板如何编写？

月夜之吻

发布时间：2025-09-07 11:20:02

886人浏览过

来源于php中文网

原创

XSLT模板的核心是通过匹配（match）和应用（apply-templates）机制，利用xsl:template、xsl:value-of、xsl:for-each、xsl:if等元素，结合XPath定位节点，实现XML到HTML或其他格式的声明式转换。

xslt模板如何编写？

编写XSLT模板，本质上是定义一套规则，告诉处理器如何将XML文档从一种结构转换成另一种，通常是HTML或其他XML格式。这就像给一个厨师菜谱，详细说明每种食材（XML节点）如何处理、组合，最终呈现一道新菜（转换后的文档）。核心在于通过匹配（

match

）特定的XML节点，然后定义这些节点应该如何被转换和输出。它不是编程，更像是一种声明式的映射，你声明想要什么结果，而不是一步步地告诉机器怎么做。

XSLT模板的编写，从我的经验来看，总是围绕着“匹配”与““应用”这两个核心概念展开。你需要先有一个XML源文档，然后用XSLT来描述你希望它最终变成什么样子。最基础的结构就是

xsl:stylesheet

元素，里面包含了各种

xsl:template

规则。每个

xsl:template

都有一个

match

属性，用来指定它要处理哪个XML节点。

举个例子，假设我们有一个简单的XML数据：

<books>
  <book id="1">
    <title>XSLT权威指南</title>
    <author>某某</author>
    <price>59.00</price>
  </book>
  <book id="2">
    <title>XML入门</title>
    <author>张三</author>
    <price>45.50</price>
  </book>
</books>

我们想把它转换成一个HTML列表。那么，我们的XSLT模板可能会这样起步：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <!-- 根模板：匹配整个文档的根节点 -->
  <xsl:template match="/">
    <html>
      <head>
        <title>我的书单</title>
      </head>
      <body>
        <h1>书籍列表</h1>
        <ul>
          <!-- 应用模板到所有的book节点 -->
          <xsl:apply-templates select="books/book"/>
        </ul>
      </body>
    </html>
  </xsl:template>

  <!-- book节点的模板：定义每个book如何显示 -->
  <xsl:template match="book">
    <li>
      <span style="font-weight: bold;"><xsl:value-of select="title"/></span>
      by <xsl:value-of select="author"/>
      (<xsl:value-of select="price"/>元)
    </li>
  </xsl:template>

</xsl:stylesheet>

在这个例子里，

xsl:template match="/"

处理整个XML文档的根，构建了HTML的基本骨架。然后，它用

xsl:apply-templates select="books/book"

来告诉处理器，“现在去找到所有

books

下的

book

节点，并为它们应用合适的模板”。接着，

xsl:template match="book"

就被激活了，它定义了每个

book

节点应该如何转换成一个

<li>

元素，并提取了书名、作者和价格。这是一种非常常见的模式，通过递归应用模板来处理XML树结构。

XSLT模板的核心结构与工作原理是什么？

XSLT模板的核心结构，说白了，就是由一个根元素

xsl:stylesheet

（或者

xsl:transform

，它们是同义的）包裹着一系列的

xsl:template

元素。这个

xsl:stylesheet

元素通常会带一个

version

属性，比如

version="1.0"

或

version="2.0"

，以及一个XML命名空间声明

xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

，这告诉处理器，这里面定义的都是XSLT指令。

每个

xsl:template

是真正定义转换规则的地方。它最关键的属性是

match

，这个属性的值是一个XPath表达式。XPath是XSLT的伙伴，它就像一个地图，用来精确地定位XML文档中的特定节点或节点集。比如

match="/"

匹配文档的根节点，

match="book"

匹配所有名为

book

的元素，

match="book[@category='fiction']"

则匹配所有

category

属性为

fiction

的

book

元素。

当XSLT处理器开始工作时，它会从XML源文档的根节点开始，遍历整个文档树。每遇到一个节点，它就会尝试找到一个与之

match

属性匹配的

xsl:template

。如果找到了，就会执行那个模板内部的指令。如果一个节点没有明确匹配的模板，XSLT有一个内置的默认模板，通常是复制文本内容并递归处理子节点。

理解这种“匹配-应用”的机制非常重要。

xsl:apply-templates

指令是驱动这种递归转换的关键。它会选择一组节点，并为这些节点寻找并应用最合适的模板。如果没有

select

属性，它会默认处理当前节点的所有子节点。这种机制使得XSLT非常适合处理层级结构化的数据，你可以为不同层级的节点定义不同的转换规则，而不需要手动编写复杂的循环和条件判断。

XSLT如何实现数据提取、循环与条件逻辑？

在XSLT中，数据提取、循环和条件逻辑是构建复杂转换的核心工具。它们让模板变得“活”起来，能够根据数据内容动态生成输出。

Wave.Video

一个在线的AI自动化视频创作平台

下载

数据提取：最常用的就是

xsl:value-of

元素。它有一个

select

属性，同样接受一个XPath表达式。这个表达式会从当前上下文节点（也就是当前正在处理的那个XML节点）开始，选择一个节点或一个属性的值，然后将其文本内容插入到输出中。比如，在

book

模板里，

xsl:value-of select="title"

会提取当前

book

元素下的

title

子元素的文本内容。如果想获取属性值，就用

符号，比如

xsl:value-of select="@id"

会提取

book

元素的

id

属性值。这非常直接，但要注意，它只会提取第一个匹配节点的文本内容，如果你期望获取多个，那通常需要结合循环。

循环：

xsl:for-each

是XSLT中实现循环的利器。它的

select

属性也接受一个XPath表达式，用于选择一组节点。然后，

xsl:for-each

会遍历这组节点中的每一个，并为每个节点执行其内部定义的指令。在每次迭代中，当前节点会变成

xsl:for-each

所处理的那个节点。这对于生成列表、表格行或者重复的HTML结构非常有用。

<!-- 示例：使用xsl:for-each遍历所有book并显示 -->
<xsl:template match="books">
  <ul>
    <xsl:for-each select="book">
      <li>
        书名: <xsl:value-of select="title"/>, 作者: <xsl:value-of select="author"/>
      </li>
    </xsl:for-each>
  </ul>
</xsl:template>

相比于

xsl:apply-templates

，

xsl:for-each

更像是传统的编程循环，它会强制按照

select

表达式选择的顺序和方式来处理节点，而

xsl:apply-templates

则会根据匹配规则和优先级来选择最合适的模板。在某些场景下，

xsl:for-each

更直观，尤其是在你不需要为子节点定义复杂模板，只是想简单遍历并输出它们的内容时。

条件逻辑：XSLT提供了

xsl:if

和

xsl:choose

两种方式来实现条件判断。

xsl:if

：它有一个

test

属性，接受一个XPath表达式，该表达式的结果会被转换为一个布尔值。如果为

true

，

xsl:if

内部的内容就会被处理并输出；否则，什么都不会发生。

<!-- 示例：如果价格大于50，则加粗显示 -->
<xsl:template match="book">
<li>
<xsl:value-of select="title"/> -
<xsl:if test="price > 50">
  <span style="font-weight: bold;">高价书！</span>
</xsl:if>
价格: <xsl:value-of select="price"/>
</li>
</xsl:template>

xsl:choose

：这相当于其他语言中的

if-else if-else

结构，可以处理多个互斥的条件。它包含一个或多个

xsl:when

子元素，每个

xsl:when

也有一个

test

属性。处理器会按顺序评估

xsl:when

的条件，第一个为

true

的

xsl:when

内部内容会被执行，然后跳出

xsl:choose

。如果所有

xsl:when

的条件都为

false

，那么可选的

xsl:otherwise

子元素（如果有的话）内部内容就会被执行。

<!-- 示例：根据价格区间显示不同信息 -->
<xsl:template match="book">
<li>
<xsl:value-of select="title"/> -
<xsl:choose>
  <xsl:when test="price > 80">
    <span style="color: red;">非常昂贵！</span>
  </xsl:when>
  <xsl:when test="price > 50">
    <span style="color: orange;">价格偏高。</span>
  </xsl:when>
  <xsl:otherwise>
    <span style="color: green;">经济实惠。</span>
  </xsl:otherwise>
</xsl:choose>
价格: <xsl:value-of select="price"/>
</li>
</xsl:template>

注意，在XML中，

和

是特殊字符，通常需要用实体引用

和

来表示。

XSLT模板编写中有哪些常见陷阱与优化技巧？

说实话，XSLT模板编写过程中，有些地方初学者很容易踩坑，而一些小技巧又能显著提升模板的效率和可维护性。

常见陷阱：

上下文节点（Context Node）的迷失：这是最常见的问题。XSLT的操作总是围绕着一个“当前上下文节点”进行的。当你使用
```
xsl:value-of select="title"
```
时，
```
title
```
是相对于当前节点而言的。但在
```
xsl:for-each
```
内部，上下文节点会变成
```
xsl:for-each
```
正在处理的那个节点。如果在这个循环里你又想访问循环外部的某个节点，比如根节点下的某个全局配置，直接写
```
title
```
或者
```
../otherNode
```
可能就不对了，你需要使用绝对路径（如
```
/books/config/setting
```
）或者通过变量来保存。
命名空间（Namespaces）问题：XML和XSLT都大量使用命名空间。如果你的源XML文档使用了命名空间，而你的XSLT模板没有正确声明或使用这些命名空间，那么XPath表达式就无法匹配到节点。比如，如果XML是
```
<doc:book xmlns:doc="http://example.com/books">
```
，你的XSLT也需要声明
```
xmlns:doc="http://example.com/books"
```
，然后用
```
doc:book
```
来匹配。忘记这一点，你会发现XPath怎么都匹配不上。
xsl:apply-templates
与
xsl:for-each
的选择：虽然它们都能实现循环，但语义和性能有时有差异。
```
xsl:apply-templates
```
更倾向于“推”模型，它让处理器根据匹配规则自动选择最合适的模板，这在处理复杂、多态的XML结构时非常强大和灵活。而
```
xsl:for-each
```
更像“拉”模型，你明确指定要遍历哪些节点，然后对它们做统一处理。滥用
```
xsl:for-each
```
可能会导致模板不够模块化，难以维护，并且在某些XSLT处理器上可能效率不如
```
xsl:apply-templates
```
。
XPath表达式的效率：复杂的XPath表达式，尤其是那些需要遍历大量节点的，可能会影响性能。比如
```
//title
```
（选择文档中所有
```
title
```
元素）通常比
```
books/book/title
```
效率低，因为它需要搜索整个文档树。尽量使用更精确的路径。

优化技巧：

模块化模板：将大的转换任务分解成小的、可重用的
```
xsl:template
```
。这不仅提高了可读性，也方便维护。一个模板只做一件事，匹配一个特定类型的节点，并定义它的输出。
使用
xsl:variable
和
xsl:param
：
```
xsl:variable
```
用于在模板内部存储计算结果或频繁使用的值，避免重复计算或重复写长XPath。
```
xsl:param
```
则允许你在调用模板时传入参数，增加模板的灵活性和复用性。
模式匹配的优先级：了解XSLT处理器如何解决多个模板匹配同一个节点时的冲突（优先级规则），这有助于你写出更精确的模板。通常，更具体的匹配模式（如
```
book[@id='1']
```
）会比一般模式（如
```
book
```
）有更高的优先级。
善用内置模板：XSLT有一些默认行为，比如默认会复制文本节点。在某些情况下，你可以利用这些默认行为，只定义需要特殊处理的节点模板，减少模板代码量。
输出方法（
xsl:output
）：在
```
xsl:stylesheet
```
的顶部，使用
```
xsl:output method="html"
```
、
```
method="xml"
```
或
```
method="text"
```
来指定输出类型。这会影响XSLT处理器如何格式化输出，比如是否添加XML声明、是否自闭合空标签等。
调试策略：XSLT调试有时确实有点棘手，因为它是声明式的。我通常会通过插入临时的
```
xsl:message
```
来输出变量值或当前上下文路径，或者直接在输出中加入调试信息，比如
```

```
，这样可以帮助我理解模板的执行流程和数据状态。