XSLT 的 mode 是用于同一节点在不同上下文中应用不同模板的机制,避免冲突并实现“一节点、多处理”;它通过为模板打标签并显式指定模式来区分处理逻辑,如 toc 和 body 模式分别生成目录和正文。

XSLT 的 mode 是一种机制,用于对同一个节点在不同上下文中应用不同的模板规则,避免模板冲突,实现“一节点、多处理”。 它本质上是模板的分类标签,让处理器能区分“这个节点现在该走哪条处理逻辑”。
mode 的作用:让同一节点有不同“身份”
默认情况下,XSLT 为每个节点只匹配一个最优先的模板(按优先级和顺序)。但现实中常需要:
– 把某个元素既生成 html 展示,又提取其文本做索引;
– 在目录中显示标题,在正文中渲染完整内容;
– 对同一段 xml,分别生成 pdf 结构、摘要文本、jsON 映射。
这时不能靠 <apply-templates></apply-templates> 默认行为搞定——它只会选一个模板。而 mode 就是给模板打标签,再用 mode 显式指定“这次我要用哪个模式处理”。
怎么定义和使用 mode
定义带 mode 的模板:
<xsl:template match="section" mode="toc"> <li><a href="#{@id}><xsl:value-of select="title"/></a></li> </xsl:template> <p><xsl:template match="section" mode="body"> <section id="{@id}"> <h2><xsl:apply-templates select="title"/></h2> <xsl:apply-templates select="para"/> </section> </xsl:template>
调用时指定 mode:
YXPHP6系统可以看做是一个模版平台,而且它又能独立工作. 而且YXPHP6系统也不需要数据库支持. 你可以开发自己的模板,也可以同步官方的模板后进行自己的二次开发,前提是您对YXPHP6要有一定的了解.YXPHP6不仅可以用作企业建站,甚至是blog,只要是您能想到的,YXPHP6几乎都可以胜任. 因为YXPHP6系统本身与模板之间可以说是独立运行的.也就是说,不管你做什么样的网站或者是应用,
0
<!-- 生成目录时用 toc 模式 --> <ul class="toc"> <xsl:apply-templates select="//section" mode="toc"/> </ul> <p><!-- 渲染正文时用 body 模式 --> <xsl:apply-templates select="/doc" mode="body"/>
注意:
– mode 名字任意,但建议语义清晰(如 summary、json、flat);
– 不带 mode 的 <apply-templates></apply-templates> 只会触发无 mode 的模板;
– 带 mode 的 <apply-templates></apply-templates> 默认只匹配同 mode 的模板(除非显式用 mode="#current" 或 mode="#default")。
mode 的常见配合技巧
- 在子节点处理中延续当前 mode:
– 写,子模板自动继承父调用的 mode,不用重复写名字 - 一个模板可声明多个 mode:
–<template match="item" mode="list summary"></template>(XSLT 2.0+ 支持空格分隔多 mode) - mode 可嵌套使用:
– 目录模板里遇到section,可以<apply-templates select="subsection" mode="toc-sub"></apply-templates>,实现分层处理 - 默认模板不受 mode 影响:
–<template match="text()"></template>这类通用模板,无论有没有 mode 都可能被调用,需留意是否要加mode限定
不使用 mode 的替代方案?
也能绕开 mode,比如:
– 用不同 select 表达式分别取节点(但逻辑重复、难维护);
– 用 <if test="..."></if> 在一个模板里分支处理(导致模板臃肿、关注点混杂);
– 用命名模板 <call-template name="gen-toc-entry"></call-template>(失去声明式匹配优势,需手动传参)。
相比之下,mode 更清晰、解耦、可组合,是 XSLT 处理多视图场景的标准做法。
基本上就这些。mode 不复杂,但容易忽略——一旦 XML 要导出多种格式或多次遍历,它就成了刚需。