首页
/ 正文

XSLT <xsl:template> 元素（千字长文）

更新时间: 2025-04-06 12:17:26

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

前言

在数据处理和格式转换领域，XSLT（可扩展样式表语言转换）是一个强大且灵活的工具。它允许开发者将 XML 数据转换为 HTML、文本或其他格式。而 <xsl:template> 元素，作为 XSLT 的核心组件，是实现这一转换逻辑的基石。无论你是刚接触 XML 转换的初学者，还是希望深入掌握 XSLT 的中级开发者，理解 <xsl:template> 的工作原理和应用场景，都将显著提升你的开发效率。

本文将从基础概念到高级技巧，通过案例和比喻，逐步解析 <xsl:template> 的功能与用法，帮助你构建可复用的转换逻辑。

什么是 XSLT 和 xsl:template？

XSLT 的核心作用

XSLT 是一种基于 XML 的语言，用于定义如何将 XML 文档转换为其他格式（如 HTML、文本等）。其核心思想是通过 模板匹配（Template Matching），将源 XML 的节点与对应的样式表规则关联，最终生成目标格式的输出。

xsl:template 的角色

<xsl:template> 是 XSLT 样式表中最关键的元素之一。它的作用可以类比为 乐高积木的拼接规则：每个模板定义了一组“操作步骤”，当源 XML 的某个节点与模板的匹配条件匹配时，XSLT 引擎就会执行该模板中的逻辑，生成对应的输出内容。

核心功能包括：

定义节点的匹配规则（如匹配某个 XML 标签）。
定义如何处理匹配到的节点（如生成 HTML 元素、计算值、调用其他模板）。
支持参数传递、继承和优先级控制，实现复杂逻辑。

xsl:template 的基础语法与结构

基本语法

<xsl:template match="pattern" name="template-name" priority="number">  
  <!-- 转换逻辑，如输出内容、调用其他模板、条件判断等 -->  
</xsl:template>

关键属性说明

属性	描述
`match`	定义模板匹配的 XML 节点路径（XPath 表达式）。
`name`	为模板命名，用于通过 `<xsl:call-template>` 显式调用。
`priority`	设置模板的优先级，用于解决匹配冲突。默认值为 `0`。

示例：匹配 XML 根元素

假设源 XML 如下：

<books>  
  <book id="1">  
    <title>XSLT 教程</title>  
    <author>张三</author>  
  </book>  
</books>

对应的 <xsl:template> 可以这样定义：

<xsl:template match="/books">  
  <html>  
    <body>  
      <h1>书籍列表</h1>  
      <xsl:apply-templates select="book"/> <!-- 处理子节点 -->  
    </body>  
  </html>  
</xsl:template>

深入理解匹配模式（match 属性）

路径表达式与匹配规则

match 属性接受 XPath 表达式，用于指定要匹配的 XML 节点。以下是一些常见用法：

1. 匹配特定标签

<xsl:template match="book">  
  <div class="book-item">  
    <h2><xsl:value-of select="title"/></h2>  
    <p>作者：<xsl:value-of select="author"/></p>  
  </div>  
</xsl:template>

2. 匹配属性或文本节点

<!-- 匹配 book 元素的 id 属性 -->  
<xsl:template match="book/@id">  
  <span>ID: <xsl:value-of select="."/></span>  
</xsl:template>  

<!-- 匹配文本节点 -->  
<xsl:template match="text()">  
  <p>文本内容：【<xsl:value-of select="."/></p>  
</xsl:template>

3. 使用通配符和层级关系

<!-- 匹配所有直接子元素 -->  
<xsl:template match="/*/*">  
  <!-- 通用处理逻辑 -->  
</xsl:template>  

<!-- 匹配 books 下的 book 元素 -->  
<xsl:template match="books/book">  
  <!-- 特殊处理逻辑 -->  
</xsl:template>

比喻：匹配模式如同快递分拣系统

想象一个快递分拣中心，每个包裹（XML 节点）会被根据标签（如“book”“author”）分配到不同的传送带（模板）。match 属性就像分拣规则，决定包裹该走哪条路径。例如，标签为“book”的包裹会被导向生成 HTML <div> 的传送带，而标签为“author”的则导向生成 <p> 的传送带。

模板的调用与协作

显式调用：通过 name 属性

若模板定义了 name 属性，则可以通过 <xsl:call-template> 显式调用：

<xsl:template name="format-price">  
  <span>¥<xsl:value-of select="price"/></span>  
</xsl:template>  

<!-- 调用模板 -->  
<xsl:call-template name="format-price"/>

隐式调用：通过 apply-templates

<xsl:apply-templates> 会自动触发匹配到的模板。例如：

<!-- 父模板 -->  
<xsl:template match="books">  
  <xsl:apply-templates select="book"/> <!-- 触发所有 book 子元素的模板 -->  
</xsl:template>  

<!-- 子模板 -->  
<xsl:template match="book">  
  <!-- 处理单个 book 的逻辑 -->  
</xsl:template>

参数传递与继承

通过 with-param 传递参数

模板之间可以通过 <xsl:with-param> 传递参数：

<!-- 定义接受参数的模板 -->  
<xsl:template name="show-message">  
  <xsl:param name="message"/>  
  <div><xsl:value-of select="$message"/></div>  
</xsl:template>  

<!-- 调用并传递参数 -->  
<xsl:call-template name="show-message">  
  <xsl:with-param name="message" select="'欢迎使用 XSLT!'"/>  
</xsl:call-template>

继承与覆盖（Inheritance）

若多个模板匹配同一个节点，XSLT 引擎会根据以下规则选择：

优先级：priority 属性值高的模板优先。
模式特异性：更具体的模式（如 book 比 * 更具体）优先。

示例：覆盖默认模板

<!-- 默认模板，匹配所有 book 元素 -->  
<xsl:template match="book">  
  <p>默认显示：【<xsl:value-of select="."/></p>  
</xsl:template>  

<!-- 高优先级模板覆盖 -->  
<xsl:template match="book[@id='1']" priority="1">  
  <div>特殊处理：ID 为 1 的书籍</div>  
</xsl:template>

实战案例：XML 转 HTML 表格

场景描述

将以下 XML 数据转换为带样式的 HTML 表格：

<employees>  
  <employee id="101">  
    <name>李四</name>  
    <department>技术部</department>  
    <salary>15000</salary>  
  </employee>  
  <employee id="102">  
    <name>王五</name>  
    <department>市场部</department>  
    <salary>12000</salary>  
  </employee>  
</employees>

XSLT 样式表实现

<?xml version="1.0" encoding="UTF-8"?>  
<xsl:stylesheet version="1.0"  
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  

  <!-- 根模板，生成 HTML 结构 -->  
  <xsl:template match="/">  
    <html>  
      <head>  
        <style>  
          table { border-collapse: collapse; }  
          th, td { border: 1px solid #ddd; padding: 8px; }  
        </style>  
      </head>  
      <body>  
        <h2>员工信息表</h2>  
        <table>  
          <tr>  
            <th>姓名</th>  
            <th>部门</th>  
            <th>薪资</th>  
          </tr>  
          <xsl:apply-templates select="employees/employee"/>  
        </table>  
      </body>  
    </html>  
  </xsl:template>  

  <!-- 处理每个 employee 节点 -->  
  <xsl:template match="employee">  
    <tr>  
      <td><xsl:value-of select="name"/></td>  
      <td><xsl:value-of select="department"/></td>  
      <td><xsl:call-template name="format-salary"/></td>  
    </tr>  
  </xsl:template>  

  <!-- 格式化薪资的独立模板 -->  
  <xsl:template name="format-salary">  
    <xsl:value-of select="format-number(salary, '¥#,##0')"/>  
  </xsl:template>  

</xsl:stylesheet>

输出结果

<html>  
<head>  
  <style>  
    table { border-collapse: collapse; }  
    th, td { border: 1px solid #ddd; padding: 8px; }  
  </style>  
</head>  
<body>  
  <h2>员工信息表</h2>  
  <table>  
    <tr>  
      <th>姓名</th>  
      <th>部门</th>  
      <th>薪资</th>  
    </tr>  
    <tr>  
      <td>李四</td>  
      <td>技术部</td>  
      <td>¥15,000</td>  
    </tr>  
    <tr>  
      <td>王五</td>  
      <td>市场部</td>  
      <td>¥12,000</td>  
    </tr>  
  </table>  
</body>  
</html>

常见问题与最佳实践

问题 1：模板未触发

原因：匹配模式不正确或节点路径错误。
解决：使用调试工具（如 Oxygen XML Editor）检查 XPath 表达式，或通过 <xsl:message> 输出日志。

问题 2：多个模板冲突

解决：

明确设置 priority 属性。
使用更具体的匹配模式（如 employee[department='技术部']）。

最佳实践

模块化设计：将重复逻辑封装为命名模板（name 属性）。
优先级控制：对关键模板显式设置 priority，避免意外覆盖。
注释与文档：为复杂模板添加注释，方便团队协作。

结论

通过本文的讲解，我们深入理解了 <xsl:template> 元素在 XSLT 中的核心作用：它不仅是 XML 转换的逻辑容器，更是实现灵活、可维护的转换流程的关键。无论是基础的节点匹配，还是高级的参数传递、模板继承，掌握这些技巧都能让你在处理 XML 数据时游刃有余。

实践建议：尝试将本文的案例代码应用到实际项目中，逐步扩展功能（如添加条件判断、循环结构）。记住，XSLT 的强大之处在于其声明式编程特性——你只需定义“如何匹配和处理”，而无需关注底层的迭代细节。

希望这篇文章能成为你探索 XSLT 的起点，帮助你高效应对 XML 相关的开发挑战！