有了實際例子之後,來仔細拆解 XSL 的語法結構與關鍵所在。
第一件要記住的事:XSL 文件本身就是 XML 文件,所以開頭同樣要有 XML 宣告。W3C 為 XSL 定義了大量標記(元素),一份 XSL 文件就是這些標記與 HTML 標記的組合。其中這一行是必須存在的:
<xsl:stylesheet xmlns:xsl="https://www.w3.org/TR/WD-xsl">
這裡 xsl:stylesheet 是 XSL 文件的根元素,所有排版樣式都包在它裡面,樣式表即由這些樣式組合而成。而 xmlns:xsl="https://www.w3.org/TR/WD-xsl" 用來宣告這份樣式表採用 W3C 制定的 XSL,設定值就是 XSL 規範所在的 URL。
也就是說,那串網址其實是一個命名空間,這是一個標準的命名空間。stylesheet、template、for-each 這些關鍵字,全都是這個命名空間所定義的。
default-space:決定是否保留 XML 文件中的空白,僅當值為 default 時保留。indent-result:決定是否保留 XSL 文件中的空白,值為 yes 時保留。language:設定 XSL 文件中使用的指令稿語言。接著看這段結構:
<xsl:template match="/"> ...... </xsl:template>
它描述的是 XSL 解析器處理 XML 文件的過程:從 match="/" 所決定的根節點開始,對文件進行遍歷,並依其中的程式碼從文件裡取出相關內容。
match 屬性的取值是個值得細究的題目。它的含義是「從 XML 文件中取出一個特定的節點集合」——XML 文件可以視為一棵樹,而 match 就是在描述要抓樹上的哪幾根枝條。這套語法其實必須符合 XPath 的規範,後續章節會詳談。以下用幾個例子說明。
<xsl:template match="/">
告訴解析程序目前要處理的是根節點底下的內容(/ 代表根節點)。
<xsl:template match="shoppingcart/item">
匹配 shoppingcart 元素下的 item 元素,而不問 shoppingcart 位於文件樹的哪個位置。假設文件中有這一段:
<shoppingcart>
<item>
<itemNo>3333</itemNo>
<itemName>屠龍刀</itemName>
</item>
<item>
<itemNo>4444</itemNo>
<itemName>離別鉤</itemName>
</item>
</shoppingcart>
那麼它匹配的內容就是那兩個 item 元素(含其子元素)。
<xsl:template match="/shoppingcart/item">
加了前導斜線之後,意義完全不同:只匹配根節點底下的 shoppingcart 裡的所有 item。如果 shoppingcart 不是直接掛在根節點下,就不符合這個匹配條件。這是多數人出錯的地方——少一個斜線,比對範圍就可能天差地遠。
<xsl:template match="price[@unit='USD']">
方括號裡是對屬性的測試,這裡只匹配 unit 屬性值為 USD 的 price 元素。這種「節點名 + 中繼條件」的寫法,讓你能針對同一種元素的情況下套用不同模板——例如美元價格與其他貨幣價格各用不同的格式輸出。
把這幾種形式放在一起看,就能理解為什麼說「學 XSL 其實是在學 XPath」:樣式表的骨架是 template,而 template 的每一個 match 都是一道 XPath 試探題。