xslt 2.0+ 中 xsl:function 用于定义命名空间限定、类型明确、无副作用的纯函数,须声明在样式表顶层,参数与返回值均需指定类型,函数体仅支持单个 xpath 表达式或 xsl:sequence。

在 XSLT 2.0 及以上版本中,xsl:function 允许你定义可复用的自定义函数,类似编程语言中的函数。它必须声明在 xsl:stylesheet 或 xsl:transform 的顶层(不能嵌套在模板、for-each 等内部),且需指定返回类型。
基本语法与声明要求
自定义函数需满足几个硬性条件:
- 必须有
name属性,格式为prefix:local-name(如my:format-date),且命名空间前缀必须已声明 - 必须指定
as属性,声明返回值类型(如xs:string、xs:integer、item()*) - 参数用
xsl:param声明,每个参数也必须有name和as,可选required="yes|no"(默认 yes) - 函数体只能包含一个 XPath 表达式或一个
xsl:sequence(推荐),不能有多个指令或副作用操作(如xsl:message仅用于调试,不改变逻辑)
简单示例:字符串首字母大写
下面是一个将字符串每个单词首字母转大写的函数:
<xsl:stylesheet version="2.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:my="http://example.com/myfunctions"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<p><xsl:function name="my:capitalize-words" as="xs:string">
<xsl:param name="text" as="xs:string"/>
<xsl:sequence select="
string-join(
for $word in tokenize($text, '\s+')
return concat(upper-case(substring($word,1,1)), lower-case(substring($word,2))),
' '
)
"/>
</xsl:function></p><p><!-- 在模板中调用 -->
<xsl:template match="/">
<result><xsl:value-of select="my:capitalize-words('hello world')"/></result>
</xsl:template></p><p></xsl:stylesheet>注意事项和常见陷阱
实际使用时容易踩坑,注意以下几点:
- 函数名必须带命名空间,即使你只在本样式表内用,也要声明并使用前缀(XSLT 不允许无命名空间的函数名)
- 不能修改全局变量、不支持“状态”或“缓存”,每次调用都是纯函数行为
- XSLT 2.0 不支持递归调用自身(XSLT 3.0 允许,但需显式声明
override="yes") - 如果函数可能返回空序列,
as类型要写成xs:string?(可选)或item()*(零个或多个) - 调试时可用
<message></message>输出参数值,但它不参与返回逻辑,也不影响结果
进阶用法:接受节点序列或返回复杂结构
函数可以处理 XML 节点,比如提取所有 price 元素的数值并求和:
<xsl:function name="my:total-price" as="xs:decimal"> <xsl:param name="items" as="element()*"/> <xsl:sequence select="sum($items/price/xs:decimal(.))"/> </xsl:function>
调用时传入节点集即可:my:total-price(/order/item)。注意参数类型声明要匹配实际传入内容,否则运行时报错。
基本上就这些。写好 xsl:function 的关键是类型明确、逻辑单一、无副作用——它不是脚本,而是声明式计算单元。










