您的位置:首页 > Web前端 > HTML

XSLT入门 -- 第2章 基础篇: XSLT快速参考1 [转]

2006-12-14 00:01 239 查看

1 前言

第1章中,我们用一个简单的XSLT样式表作为例子介绍了XSLT的概要。当然,XSLT所拥有的元素并不仅限于xsl:template、xsl:apply-templates、xsl:value-of。为了实行转换,XSLT准备了各种各样的元素。本章将以最常用的元素为中心举例说明。另外,本文中并不准备介绍元素的全部属性。详情请参见W3C标准的原文[1]及译文[2]等。在XSLT中经常会用到一种被称为XPath的描述方法。首先从XPath的概要开始介绍。

2 XPath是什么?

XPath是树结构的一种描述方法。在创建XSL样式表时经常使用XPath。

2.1 树结构

XML文档表示的数据组成数结构。用XLST进行转换,也就是从源文档的树(源树)生成转换后的树(目标树)的意思。这个转换以树结构的节点为基础来进行。节点有几种,主要为:表示根的“根节点”表示元素的“元素节点”表示属性的“属性节点”表示文本的“文本节点”表示注释的“注释节点”使用像这样的各种各样的节点来表示树的位置的描述方法称为XPath。

2.2 XPath表达式

创建XSLT样式表时经常使用的XPath表达式如表1所示。所谓的上下文节点,就是由上下文构成的节点,可以理解为“处理对象”。另外,今后会出现“当前节点”的概念,可以理解为“被选中的节点”。 1[align=center]表1: 常用的XPath表达式[/align]
记号含义
a 上下文节点的a元素
* 上下文节点的所有元素
a/b 以上下文节点的a元素为父节点的b元素
a//b 以上下文节点的a元素为祖先的b元素
a|b 上下文节点的a元素和b元素
a[表达式] 符合表达式的上下文节点的a元素
. 上下文节点
.. 上下文节点的父节点
/ 根节点
@a 上下文节点的a属性
@* 上下文节点的所有属性
node()所有节点
text()文本节点
描述类似于UNIX的路径描述。例如,
<html><body>  <a href="sample.html">示例</a>  <ul>    <li>项目A</li>    <li>项目B</li>  </ul></body></html>
中,表示元素a的XPath表达式为
/html/body/a
此外,若表示a元素的href属性,则为
/html/body/a/@href
表中a[表达式]是符合表达式的a项目的意思,例如表示第一个li项目时使用
/html/body/ul/li[1]

3 定义样式表的元素

XSLT样式表使用XML文档的格式创建。因此,必须要遵从XML文档的描述规则。XML文档中必须存在的元素只有根元素。在XSLT样式表中的根元素就是xsl:stylesheet元素。基本代码如下所示:
<xsl:stylesheet  version = "版本号"><!-- 内容: (xsl:import*, 顶层元素) --></xsl:stylesheet>
 

4 模板规则

XSLT样式表可以说是模板规则的集合。

4.1 模板规则的定义

模板规则使用xsl:template元素进行定义。它的属性包括match、name、priority和mode。其中最重要的是match属性,该属性规定了节点的样式。若没有指定name属性的话,就必须指定match属性。基本的代码如下所示。
<xsl:template   match = "样式"  name = "名称"><!-- 内容: (xsl:param*, 模板) --></xsl:template>
name属性将在调用命名模板时使用。关于命名模版将在后面讲述。 

4.2 应用模板规则

我们使用xsl:apply-template元素来应用模板规则。它包含select和mode属性。基本的代码如下所示:
<xsl:apply-templates  select = "节点集合表达式"><!-- 内容: (xsl:sort | xsl:with-param)* --></xsl:apply-templates>
后面将讲到的排序操作等之外的情况下该元素不需要内容,因此空元素标记可以写成以下的形式:
<xsl:apply-templates select="节点集合表达式"/>
未指定select属性时,当前节点为所有的子节点。 通常,仅在处理当前节点的子孙节点时使用该元素。这样就不会发生无法终了的无限循环。不能定义如下例所示的无限循环模版:
<xsl:template match="x"><xsl:apply-templates select="."/></xsl:template>
 

4.3 命名模版

带有name属性的模板规则可以通过模版名称来调用。
<xsl:call-template  name = "名称"><!-- 内容: xsl:with-param* --></xsl:call-template>
例如,定义下例所示的模板规则时,
<xsl:template name="hello">  你好</xsl:template>
可以以下面的方式调用:
<xsl:call-template name="hello"/>
输出为:
你好
 

4.4 匹配冲突

某个指定的表达式可能会出现多个匹配结果。这时根据优先度来决定应用哪个模板。定义模板规则时可通过设置priority属性来显式地指定模板优先度。如未指定,将采用默认优先度。关于默认优先度的计算方法请参见参考文献[1]。一般来说限制性强的表达式优先度较高。例如“a”的优先度要高于“*”。

4.5 内嵌模版规则

内嵌模板规则即为默认模板规则,不匹配任何模板规则的节点将由它来处理。这种机制保证了即使在不定义任何模板规则的情况下,模版处理也能递归地进行下去。应用于元素节点和根节点的内嵌模板规则如下所示。
<xsl:template match="*|/"><xsl:apply-templates/></xsl:template>
应用于文本节点和属性节点的内嵌模板规则如下所示。
<xsl:template match="text()|@*"><xsl:value-of select="."/></xsl:template>
对于其他节点(如注释节点等)不做任何处理。 这种模板规则将把文本节点内容全部输出。将代码1所示的XSLT样式表应用到某个XML文档上之后,将生成以doc为根节点、文本节点为内容的XML文档。代码1: builtin.xsl
<?xml version="1.0"?><xsl:stylesheet version="1.0"  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:template match="/">  <doc>    <xsl:apply-templates/>  </doc></xsl:template></xsl:stylesheet>
 

5 输出

虽然称为“输出”,但实际的意思是“生成目标树的节点”。可以使用源树生成节点,也可以直接生成节点。

5.1 取出文本

xsl:value-of元素可以将指定的节点的值作为字符串来输出。必须要指定select属性。
<xsl:value-of  select = "字符串表达式"/&ge9e0t;
指定的树种包含其它元素时,文本节点以外的节点将被忽略,仅输出文本。例如,
<p>.com时代的<b>IT</b>杂志</p>
对该树应用
<xsl:value-of select="p"/>
时,输出为
.com时代的IT杂志
选择当前节点可以使用“.”。若将
<a href="http://www.gihyo.co.jp">  技术评论公司</a>
作为当前节点,那么
<xsl:value-of select="."/>的URL是<xsl:value-of select="@href"/>。
的输出为
技术评论公司的URL是http://www.gihyo.co.jp。
 

5.2 节点复制

xsl:value-of元素将节点的值转换为字符串。与此相对,xsl:copy-of元素将复制节点,节点中包含的子元素原封不动。基本的代码如下所示。
<xsl:copy-of  select = "表达式"/>
例如、
<p>.com时代的<b>IT</b>杂志</p>
对此应用
<xsl:copy-of select="p"/>
的话,输出为
<p>.com时代的<b>IT</b>杂志</p>
 

5.3 属性值模板

需要生成属性值时,可以使用大括号{}将表达式括起来。。2例如,想由
<link><title>技术评论公司</title><url>http://www.gihyo.co.jp/</url></link>
生成如下的HTML链接时,
<a href="http://www.gihyo.co.jp/">  技术评论公司</a>
可以定义如下的模板规则。
<xsl:template match="link"><a href="{url}"> <xsl:value-of select="title"/></a></xsl:template>
 

5.4 生成文本

xsl:text元素可以生成文本节点。由于生成文本时直接将文本写出即可,所以一般情况下该元素不使用。但是若需要令输出的转义字符失效的话就需要使用该元素。基本代码如下所示。
<xsl:text  disable-output-escaping = "yes" | "no"><!-- 内容: #PCDATA --></xsl:text>
通过disable-output-escaping属性可以指定输出转义字符是否无效。默认值是no。指定为on时,
<xsl:text disable-output-escaping="yes"><</xsl:text>
的输出为
<
 

5.5 生成注释

需要生成注释时可以使用xsl:comment元素。
<xsl:commwnt>这里是注释。</xsl:comment>
的输出如下所示。
<!--这里是注释。-->
 

5.6 复制

复制当前节点可以使用xsl:copy元素。属性和子节点不会被自动复制。基本代码如下所示。
<xsl:copy><!-- 内容:模板 --></xsl:copy>
例如,将没有属性的上下文元素属性原样输出,可以使用如下的模板规则。
<xsl:template match="content"><xsl:copy>  <xsl:value-of select="."/></xsl:copy></xsl:template>
若需要递归地复制所有节点,可以使用如下的模板规则。
<xsl:template match="@*|node()"><xsl:copy>  <xsl:apply-templates select="@*|node()"/></xsl:copy></xsl:template>
 

5.7 生成元素

需要生成元素时可以使用xsl:element元素。通常,只要将需要生成的元素直接写出即可,不必使用xsl:element元素。该元素仅在需要动态生成元素时才有必要使用。基本代码如下所示。
<xsl:element  name = "生成元素的名称"><!-- 内容: 模板 --></xsl:element>
例如,若要由
<heading><text>这是标题。</text><size>2</size></heading>
生成HTML标题(h元素),则可以使用如下的模板规则。
<xsl:template match="heading"><xsl:element name="{concat('h', size)}">  <xsl:value-of select="text"/></xsl:element></xsl:template>
concat()是字符串连接函数。从size元素中取出值并将其连接在“h”之后构成元素名。输出如下所示。
<h2>这是标题。</h2>
 

5.8 生成属性

需要生成属性时可以使用xsl:attribute元素。与生成元素的情况相同,通常只需要将需要生成的属性直接写出即可,不需使用xsl:attribute元素。该元素仅在需要动态生成属性等场合才有必要使用。基本代码如下所示。
<xsl:attribute  name = "生成属性的名称"><!-- 内容:模板 --></xsl:attribute>
例如 ,若想由
<link> <title>技术评论公司</title> <url>http://www.gihyo.co.jp/</url></link>
[/code]
生成如下的HTML链接时,
<a href="http://www.gihyo.co.jp/">  技術評論社</a>
[/code]
可以定义如下的模板规则。
<xsl:template match="link"><a>  <xsl:attribute name="href">    <xsl:value-of select="url"/>  </xsl:attribute>  <xsl:value-of select="title"/></a></xsl:template>
[/code]
 

5.9 添加编号

需要输出整数值时可以使用xsl:number元素。基本代码如下所示。
<xsl:number  level = "源树的级别"  count = "表达式"  from = "表达式"  value = "数值表达式"  format = "表示格式的字符串" />
首先看看最简单的例子。
<items><item>A</item><item>D</item><item>B</item><item>C</item></items>
对该XML文档定义如下的模板规则。
<xsl:template match="items"><xsl:copy>  <xsl:apply-templates select="item"/></xsl:copy></xsl:template><xsl:template match="item"><xsl:copy>  <xsl:number/>  <xsl:text> </xsl:text>  <xsl:value-of select="."/></xsl:copy></xsl:template>
生成结果如下所示。
<items><item>1 A</item><item>2 D</item><item>3 B</item><item>4 C</item></items>
省略value属性时,则根据源树内当前节点的位置来输出数值。由于这个原因,若使用后面将要讲到的排序元素的话,即如果定义如下所示的模板规则的话,
<xsl:template match="items"><xsl:copy>  <xsl:for-each select="item">    <xsl:sort select="."/>    <xsl:copy>      <xsl:number/>      <xsl:text> </xsl:text>      <xsl:value-of select="."/>    </xsl:copy>  </xsl:for-each></xsl:copy></xsl:template>
输出结果将如下所示。
<items><item>1 A</item><item>3 B</item><item>4 C</item><item>2 D</item></items>
需要按照排序结果的顺序来添加编号的话,则须按照如下方式指定value属性。position()函数返回正在处理的上下文节点的位置。
<xsl:number value="position()"/>
可以使用level属性、count属性、from属性来控制编号方法。count属性设置应当被编号的节点。level属性设置作为编号对象的源树的级别。可指定的级别有single、multiple、any三种,默认值为single。 例如,有下面这种层次结构的XML文档。
<chapter title="第一章"><section title="第一节">  <subsection title="第一部分">  </subsection></section><section title="第二节">  <subsection title="第二部分">  </subsection>  <subsection title="第三部分">  </subsection></section></chapter>
将xsl:number元素的level属性设置为single,即将如下的模板规则应用于该文档,
<xsl:template match="chapter|section|subsection"><xsl:apply-templates select="@title"/><xsl:apply-templates select="*"/></xsl:template><xsl:template match="@title"><xsl:number level="single"    count="chapter|section|subsection"/><xsl:text> </xsl:text><xsl:value-of select="."/><br/></xsl:template>
转换结果如下所示。
1 第一章<br/>1 第一节<br/>1 第一部分<br/>2 第二节<br/>1 第二部分<br/>2 第三部分<br/>
也就是输出在兄弟节点中当前节点的位置。设置level属性为multiple时,转换结果如下所示。
1 第一章<br/>1.1 第一节<br/>1.1.1 第一部分<br/>1.2 第二节<br/>1.2.1 第二部分<br/>1.2.2 第三部分<br/>
编号与single相同,但是增加了父节点的编号。设置level属性为any时,转换结果如下所示。
1 第一章<br/>2 第一节<br/>3 第一部分<br/>4 第二节<br/>5 第二部分<br/>6 第三部分<br/>
也就是按照符合count指定的表达式的节点的顺序输出序号。from属性设置计数开始的位置。例如,考虑如下的XML文档。从逻辑上看,各个节点之间有父子关系,但是在源树中各个节点是并列关系。
<h1>大标题一</h1><h2>中标题一</h2><h3>小标题一</h3><h2>中标题二</h2><h3>小标题二</h3><h3>小标题三</h3>
下面使用from属性设置计数开始的节点。
<xsl:template match="h1"><xsl:number/><xsl:text> </xsl:text><xsl:value-of select="."/><br/></xsl:template><xsl:template match="h2"><xsl:number level="any" count="h1"/><xsl:text>.</xsl:text><xsl:number level="any" from="h1" count="h2"/><xsl:text> </xsl:text><xsl:value-of select="."/><br/></xsl:template><xsl:template match="h3"><xsl:number level="any" count="h1"/><xsl:text>.</xsl:text><xsl:number level="any" from="h1" count="h2"/><xsl:text>.</xsl:text><xsl:number level="any" from="h2" count="h3"/><xsl:text> </xsl:text><xsl:value-of select="."/><br/></xsl:template>
转换结果如下所示。
1 大标题一<br/>1.1 中标题一<br/>1.1.1 小标题一<br/>1.2 中标题二<br/>1.2.1 小标题二<br/>1.2.2 小标题三<br/>
使用format属性设置输出文字的格式。默认的格式为“1”,即输出数字。用于表示格式的字符串如表2所示。[align=center]表2: 格式字符串[/align]
字符串格式范例
1 1 2 ... 10 11 ...
01 01 02 ... 09 10 ... 99 100 ...
A A B ... Z AA AB ...
a a b ... z aa ab ...
i i ii iii iv v vii viii ix x ...
I I II III IV V VII VIII IX X ...
我们上面的例子中为了在xsl:number元素之后加一个空格,不得不使用了xsl:text元素。实际上只要将format属性设置为“1 ”就可以了。level属性为multiple的情况下也可以指定类似于“1.A.I”这样的格式。 3
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息