XML系列函数详解

----DOM中对象的方法 

　　本期介绍多个XSL对于VBScript、JScript增加的方法、属性，以充分发挥XML的优势，用于< xsl:script >、< xsl:eval >标记内表达式的编写或< xsl:if >、< xsl:when >的expr属性。

一、absoluteChildNumber 

含义：返回结点相对于它所有的兄弟（不论名字是否相同）的序号

语法：absoluteChildNumber(node)

参数：node ── 对象，欲返回编号的结点。

示例：

1、假定文档结构为：< document >< head/ >< body/ >< /document >，其中document为顶层结点，下述表达式将输出

< xsl:eval >

absoluteChildNumber(this.selectNodes("/document/body").item(0))

< /xsl:eval >

2、确定当前结点相对于其所有兄弟的序号

< xsl:eval >absoluteChildNumber(this)< /xsl:eval >

二、ancestorChildNumber

含义：从给定结点出发根据给定祖先结点名返回最近的祖先结点的序号（相对于同名结点）。如果找不祖先，则返回0。

语法：ancestorChildNumber(bstrNodeName, pNode)

参数：

bstrNodeName ── 字符串。被搜索的祖先结点的名字。

pNode ── 对象。搜索开始位置的结点。

示例：

查找当前结点最近的名为report祖先结点。

ancestorChildNumber("report",this)

三、attributes

含义：返回结点属性的集合

语法：object.attributes

参数：object ── 结点对象

示例：

当前结点属性的个数

this.attributes.length

当前结点第三个属性的值

this.attributs.item(2).value

或this.attributes.item(2).text

或this.attributes(2).text

注意：如果给定的下标大于属性总和减1将出错，第一个属性的下标是0。

四、baseName

含义：返回有名字空间限制的基本名，即不包括名字前缀

语法：object.baseName

参数：object ── 结点对象

示例：当前结点的基本名：this.baseName

五、childNumber

含义：返回结点相对于同名同胞的序号

语法：childNumber(object)

参数：object ─? 岬愣韵?/p> 

示例：假定XML文档结构如下

< x >< y >< z >< z/ >< y/ >< /x >

如果当前结点是z ，则childNumber(this)返回1，而absoluteChildNumber(this)返回3。 

六、dataType

含义：设定或读取结点的数据类型

语法：设定结点的数据类型 object.dataType=objvalue

读取结点的数据类型 objvalue=object.dataType

参数：object ── 结点对象

示例：读取当前结点的数据类型

dtType=this.dataType

七、depth

含义：指定结点出现在文档树上的深度，即该结点位于文档第几层，顶层结点位于

第一层，根结点（即用“/”表示的结点）位于第0层

语法：depth(pNode)

参数：pNode ── 结点对象

示例：当前结点的深度

depth(this)

八、firstChild、lastChild

含义：返回结点的第一个子结点（或最后一个子结点）。

语法：pNode.firstChild

pNode.lastChild

参数：pNode ── 结点对象

示例：当前结点的第一个结点的名字

this.firstChild.nodeName

九、formatIndex

含义：用指定的计数系统格式化提供的整数。

语法：formatIndex(lIndex, bstrFormat)

参数：

lIndex ── 整型数值或变量

bstrFormat ── 数据格式，可选值有a、A、i、I、1、01（以0打头的数值形式，如果要求固定长度的编号如0001、0002则非常有用）

示例：当前结点的大写罗马数字编号

formatIndex(childNumber(this),"I")

十、formatNumber

含义：以指定格式输出数值。

语法：formatNumber(dblNumber, bstrFormat)

参数：说明同formatNumber，不同之处在于格式化的可以是小数

示例：对变量a的值格式化为两位小数 formatNumber(a,"#.00")

十一、hasChildNodes

含义：如果结点有子结点则返回true（-1），否则为false（0）

语法：pNode.hasChildNodes()

注意：与此前介绍的函数不同，此函数后必须带一个空括号

示例：判断当前结点是否有子结点

this.hasChildNodes

十二、namespaceURI、prefix

含义：返回结点名字空间的全局资源标识符（或前缀）

语法：pNode.namespaceURI

pNode.prifix

十三、nextSibling、previousSibling、parentNode

含义：返回结点的下一个兄弟（或前一个兄弟、或结点的父结点）

语法：pNode.nextSibling

pNode.previousSibling

pNode.parentNode

　　注意：对根结点（即“/”）应用parentNode方法、对第一个孩子结点应用previousSibling方法、对最后一个孩子结点应用nextSibling方法均会导致错误，可通过此过关系运算符==（等于）和!=（不等于）来判断一个结点是否某一指定结点，格式为pNode1 = pNode2或pNode2 != pNode2。

十四、nodeName

含义：返回元素、属性、入口的名字或其他类型结点的一个特定字符串

语法：pNode.nodeName

示例：当前结点的名字

this.nodeName

十五、nodeType、NodeTypeString

含义：返回结点的类型的数值形式（或字符串形式）

语法：pNode.nodeType或pNode.nodeTypeString

返回值：

结点类型
结点类型编号 结点类型字符串

元素
1
"element"

元素属性
2
"attribute"

Markup-Delimited Region of Text 
3
"text"

Processing Instruction 
7
"processing_instruction"

Comment 
8
"comment"

Document Entity 
9
"document"

十六、nodeTypedvalue

含义：以结点预定义的数据类型返回结点的值

语法：pNode.nodeTypedvalue

示例：假定当前结点的数据类型是fixed.14.4，下例将以数值返回结点的值，而不是文本一个字符串

this.nodeTypedvalue

十七、nodevalue

含义：返回结点的文本

语法：pNode.nodevalue

注意：该方法不用于元素类结点，可用于属性、CDATA、注释、文本等结点

示例：当前元素第一个属性的值

this.attributes(0).nodevalue

当前元素内的文本（假定该元素内只有文本，无其它元素，即< mark >text< /mark >，建议多尝几次掌握其确切的用法）

this.firstChild.nodevalue

十八、ownerDocument

含义：返回包含该结点的文档的根

语法：pNode.ownerDocument

注意：该方法用于文档的根结点将出错

十九、selectNodes

含义：给定的样式匹配应用于当前结点并返回匹配的结点集合

语法：pNode.selectNodes("pattern")

提示：pattern的编写与< xsl:for-each >的select属性的值类似，其中以“/”开头表示

从文档的根出发搜索；以“//”开头表遍历文档的所有结点；以“..”开头

表示从当前结点的父结点开始；如果欲从当前结点向下搜索则不能有以上特殊字符打头。

示例：与当前结点同名的元素在其父元素内的个数

childNumber(this.selectNodes("../"+this.nodeName+"[end()]").item(0))

当前元素内名字为“skill”的元素的个数

childNumber(this.selectNodes("skill[end()]").item(0))

二十、selectSingleNode

含义：与selectNodes类似，不同的只返回匹配的第一个结点、而不是结点集合

语法：pNode.selectSingleNode("pattern")

示例：与当前结点同名的元素在其父元素内的个数

childNumber(this.selectSingleNode("../"+this.nodeName+"[end()]"))

当前元素内名字为“skill”的元素的个数

childNumber(this.selectSingleNode("skill[end()]"))

二十一、text

含义：返回结点与它的子树内的文字内容

语法：pNode.text

示例：整个文档内的文字内容

this.ownerDocument.text

当前元素及其子树的文字内容

this.text

二十二、xml

含义：返回结点及其后代的XML表示

语法：pNode.xml

示例：当前文档的XML内容

this.ownerDocument.xml

另有几个函数不作介绍，列于其下以供参考，如感兴趣，请访问http://msdn.microsoft.com获取详细说明。

formatTime(varTime, bstrFormat,varDestLocale) 

formatDate(varDate, bstrFormat,varDestLocale)

apendChild(newChild)

definition

CloneNode

insertBefore(newChild, refChild)

parsed

removeChild(oldChild)

replaceChild(newChild, oldChild)

specified

transformNode(stylesheet)

transformNodeToObject(stylesheet,outputObject) 

uniqueID(pNode)

XSL函数一 

　　本期学习XSL样式方法，即可用于XSL元素< xsl:for-each >、< xsl:value-of >、< xsl:template >的select属性、< xsl:apply-templates >的match属性、< xsl:if >、< xsl:when >的test属性中，对元素的范围进行筛选，从而提供更大的灵活性。

　　XML与DHTML（动态HTML）一样，这些节点都是一个个对象，而且这些对象都是有层次的，从根节点开始构成一颗层次清淅的树状结构，这就形成了文档对象模型DOM，通过对象的属性、方法来达到访问控制XML节点的目的。

　　我们这里不打算就XML的DOM逐一详细阐述，因为这完全可以写成一个篇幅较多的教程，我们先就一些常见的方法作一些讨论，以期对DOM的对象方法有一个大致的了解。

　　注：从本期开始，所有示例不再提供完整源代码，如有不明白之处，请仔细阅读前面七期、并动手练手。

一、end()

含义：返回集合中最后一个元素。

示例：输出最后一份简历

假定XML文件格式为：

……< resume >…< /resume >……< resume >…< /resume >……

相应XSL文件内容为：

< xsl:for-each select="resume[end()]" >……< /xsl:for-each >

或

< xsl:templates match="resume[end()]" >……< /xsl:templates >

或

< xsl:apply-template select="resume[end()]" >……< /xsl:apply-template >

二、index()

含义：返回该元素在集合中的位置，返回值是一整数，其中第一个元素返回0

示例：返回前面三份简历

resume[index() $le$ 3]

注意：index()是与父元素相关的，请看下例：

< x >

< y/ >

< y/ >

< /x >

< x >

< y/ >

< y/ >

< /x >

返回所有< x >中的第一个< y >

x/y[index()=0] 或x/y[0]

三、nodeName()

含义：返回元素的名字，即标记名

示例：选择任意元素，假如其名字（即标记名）等于“name”

*[nodeName()="name"] 或 *[name]

四、number()

含义：将值转换为数值形式，如果不是数值则返回空，要求参数

示例：年龄(age) ?0岁的人的简历(resume)

resume[number(age) $lt$ 30] 或resume[age $lt$ 30]

五、nodeType()

含义：返回结点类型，结果为是数值。以下是返回值列表：

结点类型
结点类型值 结点的字符形式描述

Element
1
"element"

Element Attribute 
2
"attribute"

Markup-Delimited Region of Text 
3
"text"

Processing Instruction 
7
"processing_instruction"

Comment
8
"comment"

Document Entity
9
"document"

六、value()

含义：返回元素或属性的值

示例：value()是元素或属性的缺省方法，以下表示是等价

name!value()="NAME"与name="NAME"

@attr="attribute_value"与@attr="attribute_value"

注：@是属性前缀，@attr表示是属性attr

七、attribute()

含义：返回所有属性结点的集合，等价于“@*”

示例：寻找所有的resume元素，满足条件至少有一个属性的值为“ABC”

resume[$any$ attribute()="ABC"]或resume[$any$ @*="ABC"]

寻找所有的resume元素，满足条件至少有一个子元素有一个属性的值为“ABC”

resume[$any$ */attribute()="ABC"]或resume[$any$ */@*="ABC"]

八、comment()

含义：返回所有注释结点

示例：例如

resume[$any$ comment()="禹希初的简历"]

表示寻找含有注释语句

< !--禹希初的简历-- >

的元素< resume >

九、cdata()

含义：返回所有CDATA类型的结点的集合

示例：例如 

resume[$any$ cdata()="禹希初的简历"]

表示寻找含有下述语句（必须是直接子结点）

< ![CDATA[禹希初的简历]] >

的元素< resume >

十、node()

含义：返回当前上下文环境中除根结点和属性结点以外的所有结点的集合，等价于

“* | pi() | comment() | text()”

示例：寻找所有元素resume，其最后一个结点的名字为"skill"

resume[node()[end()]!nodeName()="skill"]

寻找所有resume元素的第一个结点：resume/node()[0]

十一、textnode()

含义：返回所有文本类型的结点的集合

示例：寻找每一个p元素的第二个文本结点

p/textnode(1)或p!textnode(1)

十二、text()

含义：返回所有表示文本字符串的结点的集合，等价于"cdata()|textnode()"；