本階段要談的是 XSL 的樣式(pattern)函式。它們可以寫在 <xsl:for-each>、<xsl:value-of>、<xsl:template> 的 select 屬性、<xsl:apply-templates> 的 match 屬性,以及 <xsl:if>、<xsl:when> 的 test 屬性裡,用來對元素的範圍做篩選,讓轉換過程更有彈性。
在正式開始之前,先建立一個基本圖像:XML 和 DHTML 一樣,每個節點都是一個物件,而這些物件是有層次的,從根節點開始構成一棵層次清晰的樹狀結構,這就是文件物件模型 DOM(Document Object Model)。我們正是透過物件的屬性與方法,來達成存取與控制 XML 節點的目的。
DOM 的完整內容足以寫成一份獨立長篇教程,這裡不逐一細談,而是先挑幾個常用方法來說明,讓你對 DOM 的物件與方法建立大致概念。
註:從本期開始,範例不再附上完整原始碼。若有不清楚的地方,請回頭複習前面幾期,並實際動手練習。
意義:傳回集合中最後一個元素。
假設 XML 的格式為 ……<resume>…</resume>……<resume>…</resume>……,若要輸出最後一份簡歷,XSL 可以寫成:
<xsl:for-each select="resume[end()]">……</xsl:for-each> <xsl:template match="resume[end()]">……</xsl:template> <xsl:apply-templates select="resume[end()]" />
意義:傳回該元素在集合中的位置,傳回值為整數,第一個元素傳回 0。
要取出前面三份簡歷:
resume[index()$le$3]
注意:index() 是相對於父元素計算的。看以下結構:
<x><y/><y/></x> <x><y/><y/></x>
若要傳回「所有 x 中的第一個 y」,寫法是 x/y[index()=0],也可以簡寫成 x/y[0]。這正說明了 index() 的相對性:它在每個父元素底下各自重新計算。
意義:傳回元素的名稱,也就是標籤名。
要選出任意元素,但其標籤名等於 "name":
*[nodeName()='name'] 或 *[name]
意義:把值轉換成數值形式,若無法轉換則傳回空值。此函式需要參數。
要挑出年齡(age)小於 30 歲者的簡歷(resume):
resume[number(age)$lt$30] 或 resume[age$lt$30]
意義:傳回節點類型,結果為數值。對照表如下:Element=1('element')、Attribute=2('attribute')、Text=3('text')、Processing Instruction=7('processing_instruction')、Comment=8('comment')、Document=9('document')。
意義:傳回元素或屬性的值。
value() 是元素與屬性的預設方法,因此下列寫法是等價的:
name!value()="NAME" 與 name="NAME" @attr="attribute_value" 與 @attr.value()="attribute_value"
補充:@ 是屬性前置詞,@attr 即表示名為 attr 的屬性。
意義:傳回所有屬性節點的集合,等價於 @*。
找出所有 resume 元素,且至少有一個屬性的值為 "ABC":
resume[$any$attribute()='ABC'] 或 resume[$any$@*='ABC']
再往下一層——找出所有 resume 元素,且至少有一個「子元素」的屬性值為 "ABC":
resume[$any$*/attribute()='ABC'] 或 resume[$any$*/@*='ABC']
意義:傳回所有註解節點。
resume[$any$comment()='禹希初的簡歷']
這句意為:找出含有註解 <!--禹希初的簡歷--> 的 resume 元素。
意義:傳回所有 CDATA 類型節點的集合。
resume[$any$cdata()='禹希初的簡歷']
這句意為:找出含有 <![CDATA[禹希初的簡歷]]> 的 resume 元素——注意該 CDATA 必須是直接子節點。
意義:傳回當前上下文環境中,除根節點與屬性節點以外的所有節點集合,等價於:
"*|pi()|comment()|text()"
找出所有 resume 元素,其最後一個節點的名稱為 "skill":
resume[node()[end()]!nodeName()='skill']
找出所有 resume 元素的第一個節點:resume/node()[0]。
意義:傳回所有文字類型節點的集合。
找出每一個 p 元素的第二個文字節點:
p/textnode(1) 或 p!textnode(1)
意義:傳回所有表示文字字串的節點集合,等價於 cdata()|textnode()。
以上就是這一階段要介紹的樣式函式。掌握它們之後,你已經能在 select 與 test 屬性裡做出相当細緻的節點篩選——從「取最後一筆」到「某屬性值為特定字串」,都能用一行運算式表達,不必回頭改寫文件結構。
另外還有兩個函式要說明一下:date() 在我的機器上一試就出錯並導致瀏覽器自動關閉;pi() 則是尚未找到合適的應用場景,因此這裡暫不介紹。下一階段將說明如何在 XSL 中使用腳本語言,把這些方法真正組織成可運行的邏輯。