xsl:param用于声明可外部传入的只读参数,提升XSLT复用性;需由处理器注入值,支持默认值,引用时XPath中须加$前缀,与xsl:variable本质不同。

xsl:param 用于在 XSLT 样式表中声明可外部传入的参数,让样式表更灵活、可复用。它本身不提供值,值需由调用方(如 XSLT 处理器、程序代码或命令行工具)传入;若未传值,可设默认值。
基本写法和默认值
在 XSLT 中任意顶层位置(如 内、模板外)声明:
这表示参数名为 lang,若调用时没给值,就用默认值 'zh'(字符串字面量)。也可以绑定到一个表达式,比如:
在模板中使用参数
声明后,参数名就可在 XPath 表达式中直接使用(不用加 $ 前缀):
- 在匹配模板中:
(注意:这里必须加Hello $) - 在属性值模板中:
- 作为函数参数:
⚠️ 注意:在 XPath 上下文中引用参数必须加 $(如 $lang),但在 select 属性里写默认值时不用(那是静态表达式,不是变量引用)。
从外部传入参数(常见方式)
参数值不能在 XSLT 文件里“自己设”,必须由处理器注入:
-
Java(Transformer):
transformer.setParameter("lang", "en"); -
Python(lxml):
transform(xslt_root, lang=etree.XSLT.strparam("en"))(字符串需用strparam包装) -
命令行(xsltproc):
xsltproc --stringparam lang en style.xsl doc.xml(--stringparam用于字符串,--param用于 XPath 表达式) - 浏览器(旧版支持):不支持运行时传参,需预编译或改用 JS 控制
和 xsl:variable 的关键区别
别把 xsl:param 当成普通变量用:
-
xsl:param是只读的,且值来自外部;xsl:variable是本地定义、不可重赋值,但值完全由样式表控制 - 同名
param和variable共存时,param优先级更高(会覆盖同名variable) - 全局
param可被所有模板访问;局部param(在模板内声明)仅限该模板作用域(XSLT 2.0+ 支持)
基本上就这些。用好 xsl:param 能让一个样式表适配多场景,比如切换语言、开关调试模式、动态过滤条件——不复杂但容易忽略。










