XML系列函数详解
本期介绍多个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()";
posted on 2005-04-10 23:40 ξσ Dicky σξ 阅读(1135) 评论(4) 编辑 收藏 举报