本系列要介紹的是 XSL 為 VBScript、JScript 額外增補的一批方法與屬性,目的在把 XML 的優勢發揮得更徹底。這些成員可用於 <xsl:script>、<xsl:eval> 標籤內的表達式,也能寫進 <xsl:if>、<xsl:when> 的 expr 屬性裡。
回傳節點相對於它所有兄弟(不論名稱是否相同)的序號。語法:absoluteChildNumber(node),參數 node 為欲取得編號的節點。
例一,假設文件結構為 <document><head/><body/></document>,其中 document 為頂層節點,下面的表達式會輸出 body 的絕對序號:
<xsl:eval>
absoluteChildNumber(this.selectNodes("/document/body").item(0))
</xsl:eval>
例二,取得當前節點相對於其所有兄弟的序號:
<xsl:eval>absoluteChildNumber(this)</xsl:eval>
從指定節點出發,依給定的祖先節點名稱搜尋,回傳最近一個符合的祖先節點序號(相對於同名節點計算)。若找不到,回傳 0。
語法:ancestorChildNumber(bstrNodeName, pNode)。
bstrNodeName:字串,要搜尋的祖先節點名稱。pNode:物件,搜尋的起始節點。例如尋找當前節點最近的名為 report 的祖先節點:ancestorChildNumber("report", this)。
回傳節點屬性的集合。語法:object.attributes,object 為節點物件。
例如統計當前節點的屬性數量:this.attributes.length。
取得第三個屬性的值,有以下幾種等價寫法:
this.attributes.item(2).value this.attributes.item(2).text this.attributes(2).text
注意:若給定的索引大於屬性總數減 1 就會出錯,而第一個屬性的索引是 0。
回傳受命名空間限制的基本名稱,也就是不含命名空間前綴的部分。語法:object.baseName。取得當前節點的基本名稱:this.baseName。
回傳節點相對於同名兄弟的序號。語法:childNumber(object)。
以下面結構為例:
<x><y><z><z/></y></x>
如果當前節點是最外層的 z,那麼 childNumber(this) 回傳 1,而 absoluteChildNumber(this) 回傳 3。差別就在於前者只數同名的兄弟,後者則把所有兄弟都算進來。