如何在XSLT中生成唯一的ID,generate-id()函数怎么用?

1次阅读

generate-id() 是 XSLT 中为节点生成稳定唯一字符串标识符的函数,用于单次转换中锚点链接、key 查找等场景,不创建新 ID 也不依赖 @id 属性,仅基于节点本身映射。

如何在XSLT中生成唯一的ID,generate-id()函数怎么用?

generate-id() 是 XSLT 1.0 和 2.0 中用于为节点生成唯一字符串标识符的内置函数,它不保证全局唯一(比如跨不同样式表运行时),但在单次转换中对同一节点始终返回相同值,且对不同节点通常返回不同值。它不是用来“创建新ID”的工具,而是为已有节点提供可预测、稳定的引用名,常用于 id 属性、key 查找或生成 href/id 配对(如 html 锚点)。

基本用法:为当前节点或指定节点生成ID

语法很简单:

  • generate-id() —— 作用于当前上下文节点(即当前被匹配的节点)
  • generate-id($node) —— 作用于传入的节点变量或路径表达式结果(必须是单个节点,不能是节点集)

例如,在模板中匹配一个 <section></section> 元素时:

<section id="{generate-id()}">...

会生成类似 id="N12345" 的属性值(具体格式由处理器决定,常见为 N + 数字或内部指针哈希)。

配合 key 和 ID 引用:实现“锚点跳转”

这是最典型的应用场景:给标题加 id,再让目录项链接到它。

假设 xml 有多个 <h2></h2>

<doc>   <h2>简介</h2>   <h2>安装步骤</h2> </doc>

XSLT 可这样写:

如何在XSLT中生成唯一的ID,generate-id()函数怎么用?

Notion Sites

Notion 推出的AI网站构建工具,允许用户将 Notion 页面直接发布为完整网站。

如何在XSLT中生成唯一的ID,generate-id()函数怎么用? 246

查看详情 如何在XSLT中生成唯一的ID,generate-id()函数怎么用?

<xsl:template match="h2">   <h2 id="{generate-id()}">     <xsl:apply-templates/>   </h2> </xsl:template>  <xsl:template match="doc">   <nav>     <xsl:for-each select="h2">       <a href="#{generate-id()}"><xsl:value-of select="."/></a>     </xsl:for-each>   </nav>   <xsl:apply-templates/> </xsl:template>

注意:两个 generate-id() 调用分别作用于同一个 h2 节点(for-each 中的当前节点),因此生成的字符串一致,链接能正确跳转。

注意事项和常见误区

⚠️ generate-id() 不等于 xml:id 或 @id 属性:它不读取也不设置元素的 id 属性,只是基于节点内存地址/位置生成标识符。

⚠️ 不能用于非节点类型:传入字符串、数字或空序列会报错(XSLT 2.0+ 可能返回空字符串,但行为不可靠)。

⚠️ 不适用于排序后重排的节点集:如果用 for-each 配合 sort,再对每个项调用 generate-id(),ID 仍对应原始文档中的节点,不会因排序改变——这点很有用,也容易误解。

✅ 替代方案(如需真正语义化 ID):XSLT 2.0+ 可用 uuid:uuid()(需扩展函数)或拼接自定义前缀 + 位置(如 'sec-' || position()),但 lose 了节点绑定特性。

基本上就这些。generate-id() 核心价值在于“稳定映射节点到字符串”,用对了很轻量,滥用反而导致不可维护。不复杂但容易忽略它的节点绑定本质。

text=ZqhQzanResources