XML 負責承載資料,HTML 負責呈現畫面,而 XSLT 正好站在兩者之間,扮演轉換樞紐的角色。可惜在規範演進的過程中,「把一份 XML 簡單地鋪成一張表」這件看起來很基本的需求,反而長期讓人傷腦筋。
本文以一個「資料夾/檔案/欄位」的三層結構為例,示範如何只靠一份 XSL 樣式表,就把嵌套的 XML 直接渲染成可編輯的表單版面。
假設手上有一份描述頁面內容的 XML,我們希望把它鋪排成實際的版面:
<?XML version='1.0'?>
<?XML-stylesheet type="text/xsl" href="article.xsl"?>
<XML>
<folders>
<folder>
<text>Folder 1</text>
<files>
<file>
<text>File 1</text>
<fields>
<field>
<data>
<type>string</type>
<length>50</length>
<value>some data</value>
</data>
</field>
</fields>
</file>
</files>
</folder>
</folders>
</XML>
這段結構的語意很清楚:一組資料夾,每個資料夾底下有若干檔案,每個檔案又包含若干供使用者填寫的欄位。
對應的呈現邏輯可以這樣安排:
<?XML version="1.0"?>
<xsl:stylesheet
XMLns:xsl="https://www.w3.org/1999/XSL/Transform" version="1.0"
XMLns:msxsl="urn:schemas-microsoft-com:xslt"
XMLns:fn="https://www.mycompany.com/mynamespace">
<xsl:output method="Html"/>
<msxsl:script language="JScript" implements-prefix="fn">
function getElementCount(nodelist, what) {
var rtrn = 0;
rtrn = nodelist[0].parentNode.selectNodes(what).length;
return (rtrn + 1); // 多出的 1 用來補足佔位 TD
}
</msxsl:script>
<xsl:template match="/">
<TABLE CELLSPACING="0" CELLPADDING="0" WIDTH="100%" BORDER="0"
ID="tblRoot" NAME="tblRoot" style="table-layout:fixed;">
<TR>
<xsl:for-each select="XML/folders/folder">
<xsl:element name="TD">
<xsl:attribute name="style">width:55px</xsl:attribute>
<xsl:value-of select="text"/>
</xsl:element>
</xsl:for-each>
<TD></TD>
</TR>
<xsl:for-each select="XML/folders/folder">
<TR>
<xsl:element name="TD">
<xsl:attribute name="colspan">
<xsl:value-of select="fn:getElementCount(., 'folder')"/>
</xsl:attribute>
<TABLE CELLSPACING="0" CELLPADDING="0" WIDTH="100%" BORDER="0"
style="table-layout:fixed;">
<TR>
<xsl:for-each select="files/file">
<xsl:element name="TD">
<xsl:attribute name="style">width:55px;</xsl:attribute>
<xsl:value-of select="text"/>
</xsl:element>
</xsl:for-each>
<TD></TD>
</TR>
<xsl:for-each select="files/file">
<TR>
<xsl:element name="TD">
<xsl:attribute name="colspan">
<xsl:value-of select="fn:getElementCount(., 'file')"/>
</xsl:attribute>
<xsl:for-each select="fields/field">
<xsl:element name="INPUT">
<xsl:attribute name="type">text</xsl:attribute>
<xsl:attribute name="maxlength">
<xsl:value-of select="data/length"/>
</xsl:attribute>
<xsl:attribute name="value">
<xsl:value-of select="data/value"/>
</xsl:attribute>
</xsl:element><BR/>
</xsl:for-each>
</xsl:element>
</TR>
</xsl:for-each>
</TABLE>
</xsl:element>
</TR>
</xsl:for-each>
</TABLE>
</xsl:template>
</xsl:stylesheet>
在 stylesheet 根元素上宣告的三組命名空間並非裝飾,而是各有各的職責:
fn:函式名(...) 的方式呼叫。版面之所以能對齊,關鍵在於每一層的 TD 都要跨足夠的欄數。做法是先建外層 TABLE 與第一個 TR,為每個資料夾輸出一個固定寬度的 TD;接著為每個資料夾另起一個 TR,只放一個 TD,並把它的 colspan 設為「同層資料夾數量 + 1」。多出來的那一格,用來填補 table-layout:fixed 版面裡的剩餘空間。
計算交給 getElementCount 完成:傳入當前節點(以「.」表示)與要統計的節點名稱,函式先取得父節點,再用 XPath 查詢同名子節點的數量,最後加一傳回。檔案層的處理完全比照辦理,只是統計的對象換成 file。
拿到這個 TD 之後,往裡頭再嵌一個 TABLE 裝檔案;檔案層結束後,最內圈不再多包一層 TABLE,而是直接把每個 field 產生的 INPUT 依序放進當前 TD,maxlength 取自 data/length,初始值取自 data/value。
版面骨架完成後,互動性可以另外疊上去。例如要做「點標籤才展開對應資料夾」的效果,只要替資料夾與檔案的 TD 補上一個 onclick 的 xsl:attribute,值指向你的 Script 函式名稱即可,再用它來控制其他列的顯示與隱藏。
視覺外觀同樣不必動到結構:加上 class 的 xsl:attribute,並在 STYLE 區塊或外部 CSS 中定義對應的類別名稱,就能換色、換框、換字型。
這個 File-Folder-Field 的三層視圖,正好是許多 Web 資料部署方案裡常見的骨架;把它的轉換思路吃透,後續要改成產品分類、選單結構或權限樹,都只是換標籤名稱的事。想深入微軟的 XML 相關規範,MSDN Library 仍是值得翻查的第一手來源。