跟我学XSL(9)XSL函数二

【 tulaoshi.com - Web开发 】

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

　　一、absoluteChildNumber

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

　　语法：absoluteChildNumber(node)

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

　　示例：

　　1、假定文档结构为：documenthead/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 ── 结点对象

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

　　xyz/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

　　返回值：

　　十六、nodeTypedValue

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

　　语法：pNode.nodeTypedValue

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

　　this.nodeTypedValue

　　十七、nodeValue

　　含义：返回结点的文本。

　　语法：pNode.nodeValue

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

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

　　this.attributes(0).nodeValue

　　当前元素内的文本（假定该元素内只有文本，无其它元素，即marktext/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)