聽到「樣式表」,多數人第一時間想到的是 CSS。但 XSLT 樣式表其實也能扮演類似角色——它最常被用於 XML 轉換,例如在 Web 服務之間映射資料。正因為太適合這類工作,XSLT 甚至提供了 <xsl:transform> 作為頂層元素 <stylesheet> 的別名(雖然很少有人用)。傳統 XSLT 轉換的輸入與輸出結構差異極大,最明顯的就是命名空間不同。
而當 XSLT 用來處理 HTML 時,情況反過來:輸入與輸出結構相近,只是輸入多了一些額外標記,其餘大部分原樣複製到輸出;兩者的命名空間相同(HTML);輸入文件還可以包含屬於其他命名空間的指令,這些指令不會被帶進輸出。
本文使用的縮寫:
CSS:層疊樣式表
XHTML:可擴充超文本標記語言
XPath:XML 路徑語言
XSLT:可擴充樣式表語言轉換
XSLT 不會取代 JavaScript 或 CSS。字體、粗細、顏色、間距交給 CSS 就好;但若要組合來自不同位置的資訊——例如生成腳注、插入共用模組、自動產生目錄——CSS 就無能為力了。這是互補而非替代的關係。
為求示範清晰,本文各範例分別放在獨立檔案中。清單 1 是所有範例共用的基礎程式碼。
清單 1. 基礎樣式(samples/common.xml)
XML/HTML Code復制內容到剪貼板
XHTML 的命名空間宣告了兩次:一個是預設命名空間,用於輸出時不必寫前綴;另一個是 h:,用在 XPath 表達式中比對節點。
兩個模板的分工要記清楚:match="h:head" 在源文件的 head 中插入 CSS 連結與 content-type 宣告(即使 UTF-8 是 XML 預設編碼,部分瀏覽器仍需 content-type 才肯正確呈現);match="*" 則是預設的「完整複製」模板,把所有內容原封不動搬進目標文件。如果少了後者,輸出將只剩標記裡的文字,處理指令節點也不會被複製。
本文使用 XSLT 1.0。目前多數瀏覽器仍無法解釋 XSLT 2.0,但若轉換發生在伺服器端,2.0 會是相當實用的選擇,它額外提供了 XPath 2.0(含 if…then…else 與大量內建函數)、使用者自訂 XPath 函數,以及分組能力。
清單 1 裡插入 CSS 連結就是一種擴充。再看一個例子:為每個內部連結加上小箭頭,提示目標在當前位置之前(^)還是之後(v)。
清單 2. 樣式表(samples/linkUpDown.xsl)
XML/HTML Code復制內容到剪貼板
先匯入共用樣式,接著比對所有以「#」開頭的內部連結。若錨點位於連結之前,補上向上箭頭;反之補上向下箭頭。s:copy-of 與 s:apply-templates 確保屬性與子節點都不會在半路被丟掉。
清單 3. 源文件(samples/linkUpDown.xml)
XML/HTML Code復制內容到剪貼板
清單 4. 輸出文件(samples/linkUpDown.html)
XML/HTML Code復制內容到剪貼板
你可以在源文件中放入屬於另一個命名空間(此例前綴為 a:)的指令,這些元素不會被複製到輸出。清單 5 中,任何位置的 a:ref 都會生成一個腳注。
清單 5. 樣式表(samples/footnote.xsl)
XML/HTML Code復制內容到剪貼板
邏輯是這樣的:若源文件寫了 a:references,名為 references 的模板會在該位置列出所有腳注;若沒寫,與 body 匹配的模板會在 body 結尾呼叫同一個模板。兩種情況下都會列出腳注內容,並產生向上箭頭的回跳連結。第二個模板(比對 a:ref)則負責在內文中產生帶編號的向下箭頭連結。
輸出中的 class="footnote" 由 common.xsl 裡連結的 CSS 樣式表接手處理——這正是 XSLT 與 CSS 分工互補的寫照。
清單 6. 源文件(samples/footnote.xml)
XML/HTML Code復制內容到剪貼板
清單 7. 輸出文件(samples/footnote.html,節錄)
XML/HTML Code復制內容到剪貼板
XSLT 也能引用其他文件的片段。a:include 指令會抓取某個 id 對應的元素並就地轉換。
清單 8. 樣式表(samples/include.xsl)
XML/HTML Code復制內容到剪貼板
三個分支的優先順序很清楚:先看 a:include 自帶的 src;若無,退回 a:default 的 src;兩者皆無則在當前文件內查找。用 refid 去比對 id,可以避開自我遞迴造成的無限迴圈。
清單 9. 源文件(samples/include.xml,節錄)
XML/HTML Code復制內容到剪貼板
清單 10. 被引用的片段(samples/includeY.xml)
XML/HTML Code復制內容到剪貼板
清單 11. 輸出文件(samples/include.html,節錄)
XML/HTML Code復制內容到剪貼板
被引入的元素可以具備複雜結構,套用模板後一樣能被完整轉換。
若你的簡報由多頁組成,可以用一個主文件統籌頁面標題與連結,自動生成完整的頁面導航,包含上一頁、下一頁與任意跳轉。這部分細節超出本文範圍,但概念與上面的 include 機制一脉相承。
解釋:頁面以 XML 形式提供(副檔名 .xml,content-type 為 text/xml 或 application/xml),由瀏覽器讀取處理指令並就地執行 XSLT。
編譯:瀏覽器收到的是已轉換好的 HTML(副檔名 .html,content-type 為 text/html),轉換發生在請求之前,於開發環境或伺服器上完成。Xalan 與 Saxon 都是常見的 XSLT 處理器。
解釋式的優點:
缺點同樣要正視:
無論走哪條路,記住順序:XSLT 轉換先發生,之後才轮到 CSS 與 JavaScript 接手。
XSLT 樣式表能把「結構生成」這件事從靜態 HTML 中抽離出來,讓擴充、腳注、跨文件組合成為宣告式的規則。把本文的範例當作起點,你也能打造屬於自己的樣式表。