在可扩展样式表语言转换（XSLT）的开发实践中，将外部数据或动态配置传递给模板是一项非常基础且关键的操作。通过参数传递机制，开发者能够编写出更加灵活、可复用的样式表代码，从而避免为微小的差异重复编写相似的模板逻辑。本文将深入探讨XSLT中参数传递的核心原理、具体实现步骤以及在实际应用中的注意事项。
XSLT参数传递的核心机制与标签解析
XSLT的参数传递体系主要依赖两个核心标签来构建，它们分别是用于在模板内部接收和定义参数的<xsl:param>，以及用于在调用模板时实际传递参数值的<xsl:with-param>。这两个标签各司其职，共同完成了数据从调用方到被调用方的流转过程。理解它们的区别与联系，是掌握XSLT参数传递的前提。
<xsl:param>标签的主要职责是声明模板所需的输入参数。它必须放置在<xsl:template>标签内部的最前面，作为该模板的形参定义。在声明时，开发者可以选择为参数指定一个默认值。当调用方没有显式传递该参数时，模板将自动使用这个默认值，这极大地增强了模板的健壮性和容错能力。如果不设置默认值且调用时未传参，该参数将被视为空字符串。
与<xsl:param>相对应，<xsl:with-param>标签负责在调用模板时提供实参。它不能独立存在，必须嵌套在<xsl:apply-templates>或<xsl:call-template>标签内部。在使用时，<xsl:with-param>的name属性必须与目标模板中<xsl:param>定义的参数名严格保持一致，这样才能确保参数值被正确映射和接收。
参数传递的完整实战演练
为了更直观地理解参数传递的完整流程，我们首先准备一份简单的XML数据源。这份数据包含了一个书店的信息，其中有不同类别的书籍及其价格。我们将通过XSLT将其转换为HTML格式，并在转换过程中通过参数控制价格的显示方式。
<?xml version="1.0" encoding="UTF-8"?>
<bookstore>
<book category="编程">
<title>XSLT入门教程</title>
<price>59.9</price>
</book>
<book category="文学">
<title>散文精选</title>
<price>39.9</price>
</book>
</bookstore>
接下来，我们编写XSLT样式表。首先定义一个处理根节点的主模板，然后在其中定义一个专门处理book节点的子模板。在这个子模板中，我们使用<xsl:param>定义了两个参数：一个用于控制是否显示价格，另一个用于定义价格的前缀文本。在模板内部，通过条件判断和变量引用来使用这些参数。
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 匹配根节点，遍历所有book节点 -->
<xsl:template match="/">
<html>
<body>
<h2>书籍列表</h2>
<xsl:apply-templates select="bookstore/book"/>
</body>
</html>
</xsl:template>
<!-- 处理book节点的模板，定义两个参数 -->
<xsl:template match="book">
<!-- 定义参数showPrice，默认值为yes，控制是否显示价格 -->
<xsl:param name="showPrice">yes</xsl:param>
<!-- 定义参数pricePrefix，默认值为空，作为价格的前缀 -->
<xsl:param name="pricePrefix"></xsl:param>
<p>
书名：<xsl:value-of select="title"/>
<!-- 判断是否显示价格 -->
<xsl:if test="$showPrice = 'yes'">
，价格：<xsl:value-of select="$pricePrefix"/><xsl:value-of select="price"/>元
</xsl:if>
</p>
</xsl:template>
</xsl:stylesheet>
在根模板中调用处理book节点的模板时，我们通过<xsl:with-param>为不同的书籍节点传递不同的参数值。例如，对于第一本书，我们传递参数使其不显示价格；对于第二本书，我们不仅让其显示价格，还传递了特定的前缀。转换引擎在处理时，会根据传入的参数生成最终的HTML结构。
<xsl:template match="/">
<html>
<body>
<h2>书籍列表</h2>
<!-- 给第一本书传递参数，不显示价格 -->
<xsl:apply-templates select="bookstore/book[1]">
<xsl:with-param name="showPrice">no</xsl:with-param>
</xsl:apply-templates>
<!-- 给第二本书传递参数，显示价格，前缀为售价 -->
<xsl:apply-templates select="bookstore/book[2]">
<xsl:with-param name="showPrice">yes</xsl:with-param>
<xsl:with-param name="pricePrefix">售价：</xsl:with-param>
</xsl:apply-templates>
</body>
</html>
</xsl:template>
上述XSLT转换后的HTML结果如下所示，可以看到第一本书没有显示价格，而第二本书正确应用了传入的前缀和价格数据。
<html>
<body>
<h2>书籍列表</h2>
<p>书名：XSLT入门教程</p>
<p>书名：散文精选，价格：售价：39.9元</p>
</body>
</html>
命名模板的参数传递与进阶注意事项
除了使用<xsl:apply-templates>进行模式匹配调用外，XSLT还允许通过<xsl:call-template>直接调用命名模板。这种方式在复用特定逻辑时非常有用。命名模板同样支持参数传递，其机制与前述完全一致。我们定义一个专门用于格式化价格的命名模板，接收价格和货币单位两个参数，并在主逻辑中通过<xsl:call-template>调用它，同时传入具体的节点值和静态文本。
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- 定义命名模板 -->
<xsl:template name="formatPrice">
<xsl:param name="price"/>
<xsl:param name="unit">元</xsl:param>
价格：<xsl:value-of select="$price"/><xsl:value-of select="$unit"/>
</xsl:template>
<!-- 调用命名模板传递参数 -->
<xsl:template match="book">
<p>
书名：<xsl:value-of select="title"/>，
<xsl:call-template name="formatPrice">
<xsl:with-param name="price">
<xsl:value-of select="price"/>
</xsl:with-param>
<xsl:with-param name="unit">人民币</xsl:with-param>
</xsl:call-template>
</p>
</xsl:template>
</xsl:stylesheet>
在实际开发中应用参数传递时，有几个关键细节需要特别注意。首先，参数名称是严格区分大小写的，<xsl:with-param>中的name属性值必须与<xsl:param>中的名称完全匹配。其次，参数的作用域被严格限制在定义它的模板内部，不同模板中即使存在同名参数，它们也是相互独立的，不会发生命名冲突。
此外，<xsl:with-param>传递的值不仅限于静态的文本字符串，它完全支持XPath表达式。这意味着你可以通过<xsl:value-of>等指令动态提取XML源文件中的节点值作为参数传递，从而实现数据驱动的动态转换。掌握这些进阶技巧，能够大幅提升XSLT样式表的灵活性与表现力。
综上所述，XSLT的参数传递机制为样式表的模块化与复用提供了强有力的支持。通过合理运用<xsl:param>与<xsl:with-param>，开发者可以构建出高度可配置的转换逻辑。在日后的开发实践中，建议多尝试结合XPath表达式进行动态传参，并严格遵循参数命名与作用域的规范，以编写出更加优雅、高效的XSLT代码。
XSLT模板参数参数传递XSLT_template修改时间：2026-06-19 03:03:48