這一階段要介紹的是 XSL 為 VBScript、JScript 額外擴充的一組方法與屬性。善用它們,可以更充分地發揮 XML 的表達能力,無論是寫在 <xsl:script>、<xsl:eval> 標籤內的運算式,還是 <xsl:if>、<xsl:when> 的 expr 屬性裡,都能派上用場。
意義:傳回節點相對於它所有兄弟(不論名稱是否相同)的序號。
語法:absoluteChildNumber(node),參數 node 為欲取得編號的節點。
<xsl:eval>absoluteChildNumber(this.selectNodes('/document/body').item(0))</xsl:eval>
<!-- 取得目前節點相對於所有兄弟的序號 -->
<xsl:eval>absoluteChildNumber(this)</xsl:eval>
意義:傳回節點相對於「同名」兄弟的序號。
語法:childNumber(object)。
若文件結構為 <x><y><z></z></y></x>,當前節點是 z 時,childNumber(this) 傳回 1,而 absoluteChildNumber(this) 傳回 3——兩者的差異就在「是否計入不同名的兄弟」。
意義:從指定節點出發,搜尋指定名稱的祖先節點,傳回該祖先相對於同名節點的序號;找不到祖先時傳回 0。
語法:ancestorChildNumber(bstrNodeName, pNode)。bstrNodeName 為被搜尋的祖先名稱,pNode 為搜尋起點。
ancestorChildNumber('report', this) /* 找出當前節點最近的 report 祖先 */
意義:指定節點在文件樹中的深度。頂層節點位於第一層,而以「/」表示的根節點位於第 0 層。
語法:depth(pNode)。範例:depth(this)
意義:傳回節點所有屬性的集合。
語法:object.attributes
this.attributes.length /* 目前節點的屬性個數 */ this.attributes.item(2).value /* 第三個屬性的值 */ this.attributes.item(2).text /* 亦可寫成 .text */ this.attributes(2).text /* 亦可寫成 this.attributes(2).text */
注意:第一個屬性的索引是 0;若索引大於屬性總數減 1 會出錯。
意義:傳回受限於名稱空間的「基本名」,也就是不含前置詞的部分。
語法:object.baseName,例如 this.baseName。
意義:傳回元素、屬性或參照的名稱;其他類型節點則傳回一個固定的字串。
語法:pNode.nodeName,例如 this.nodeName。
意義:傳回節點類型的數值形式或字串形式。
語法:pNode.nodeType 或 pNode.nodeTypeString
常見對照如下:Element=1('element')、Attribute=2('attribute')、Text=3('text')、Processing Instruction=7('processing_instruction')、Comment=8('comment')、Document=9('document')。
nodeValue 傳回節點的文字內容,但不適用於元素類節點,可用於屬性、CDATA、註解、文字等節點。
this.attributes(0).nodeValue /* 第一個屬性的值 */ this.firstChild.nodeValue /* 元素內的文字,例如 <mark>text</mark> */
nodeTypedValue 則是依節點預先定義的資料型別傳回值。若當前節點型別為 fixed.14.4,this.nodeTypedValue 會以數值而非字串形式傳回,這在需要精確運算時很重要。
text 傳回節點及其子樹內的所有文字內容:this.ownerDocument.text 是整份文件的文字,this.text 則是目前元素及其子樹。
XML 傳回節點及其後代的 XML 表示,例如 this.ownerDocument.XML 會輸出整份文件的 XML 內容。
意義:傳回節點名稱空間的全球資源識別符(namespaceURI)或前置詞(prefix)。
語法:pNode.namespaceURI、pNode.prefix。
意義:傳回包含該節點的文件根。
語法:pNode.ownerDocument。注意:對文件根節點本身套用此方法會出錯。
意義:設定或讀取節點的資料型別。
object.dataType = objValue /* 設定 */ objValue = object.dataType /* 讀取,例如 dtType = this.dataType */
意義:節點有子節點時傳回 True(-1),否則為 False(0)。
語法:pNode.hasChildNodes()——與其他方法不同,這個函式後面必須帶一對空括號。範例:this.hasChildNodes()
意義:傳回節點的第一個(或最後一個)子節點。
語法:pNode.firstChild、pNode.lastChild。例如 this.firstChild.nodeName 可取得第一個子節點的名稱。
意義:傳回節點的下一個兄弟、上一個兄弟或父節點。
語法:pNode.nextSibling、pNode.previousSibling、pNode.parentNode。
注意:對根節點("/")套用 parentNode、對第一個子節點套用 previousSibling、對最後一個子節點套用 nextSibling,都會導致錯誤。實務上可用相等運算子 == 與 != 來判斷某節點是否為指定節點,寫成 pNode1 == pNode2 或 pNode2 != pNode2。
意義:把指定的樣式比對套用到當前節點,傳回所有符合的節點集合。
語法:pNode.selectNodes('pattern')
pattern 的寫法與 <xsl:for-each> 的 select 屬性類似:以「/」開頭表示從文件根開始搜尋;以「//」開頭表示遍歷整份文件;以「..」開頭表示從父節點開始;若要從當前節點往下搜尋,則不能加上這些特殊字元。
/* 與當前節點同名的元素,在其父元素內共有幾個 */
childNumber(this.selectNodes("../" + this.nodeName + "[end()]").item(0))
/* 當前元素內名為 skill 的元素個數 */
childNumber(this.selectNodes("skill[end()]").item(0))
意義:與 selectNodes 相同,但只傳回符合條件的「第一個」節點,而非集合。
語法:pNode.selectSingleNode('pattern')
childNumber(this.selectSingleNode("../" + this.nodeName + "[end()]"))
childNumber(this.selectSingleNode("skill[end()]"))
意義:用指定的計數系統格式化一個整數。
語法:formatIndex(lIndex, bstrFormat)。bstrFormat 可為 a、A、i、I、1、01;其中「01」這種以 0 開頭的形式,在需要固定長度編號(如 0001、0002)時非常有用。
formatIndex(childNumber(this), 'I') /* 轉成大寫羅馬數字編號 */
意義:以指定格式輸出數值,與 formatIndex 的差别在於它可以處理小數。
語法:formatNumber(dblNumber, bstrFormat)。
formatNumber(a, '#.00') /* 把變數 a 格式化為兩位小數 */
還有一批函式在此不逐一展開,有興趣的讀者可以到微軟官方文件查詢更詳細的說明:formatTime、formatDate、appendChild、cloneNode、insertBefore、removeChild、replaceChild、transformNode、transformNodeToObject、uniqueID、parsed、specified、definition 等。其中 transformNode 與 transformNodeToObject 尤其值得一試——它們讓你能在程式碼中直接對節點套用 XSL 轉換,是把「資料」與「呈現」分離落實到實戰的關鍵函式。