摘要:本文以實作範例說明,如何用 XSL 把 XML 資料轉換成多列多欄的 Table,並補上最容易被忽略的「末列補齊」問題。
用 XSL 轉換 XML 時,把資料排成多欄 Table 是常見需求,也經常讓人卡住。如果只是要換行,取模判斷再補一個 <br/> 就能打發;但為了版面好看而必須生成真正的多列多欄表格時,事情就沒那麼簡單了。
最直覺的思路是用 position() mod 3 = 1 挑出每列的起始元素,再用 following-sibling 抓取同一列上的第二、第三個元素:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:copyRight="https://xml.sz.luohuedu.net/">
<xsl:template match="/">
<table bgcolor="snow" border="1" cellpadding="5" cellspacing="2"
borderColor="darkorange" style="font-size:9pt">
<xsl:for-each select="/Items/Item[position() mod 3 = 1]">
<tr>
<td width="33%" align="center" valign="middle">
<xsl:apply-templates select="."/>
</td>
<td width="34%" align="center" valign="middle">
<xsl:apply-templates select="following-sibling::Item[position() = 1]"/>
</td>
<td width="33%" align="center" valign="middle">
<xsl:apply-templates select="following-sibling::Item[position() = 2]"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:template>
<xsl:template match="/Items/Item">
<a target="_blank">
<xsl:attribute name="href">
<xsl:if test="contains(Url,'@')">mailto:</xsl:if><xsl:value-of select="Url"/>
</xsl:attribute>
<xsl:value-of select="Title"/>
</a>
</xsl:template>
</xsl:stylesheet>
轉換結果如下圖:

看起來沒問題,但仔細檢查輸出的 HTML 就會發現破綻:當紀錄數目不是欄數的整數倍時,最後一列剩下的幾格不會被生出來,也就是說 HTML 裡少了對應的 <td></td>。表格雖然還看得,但結構不完整,套上框線或背景色時就會露出破洞。
要解決這個問題,得先算出總紀錄數,接著算出距離整數列還差幾格,最後把缺的格子補上。而在補齊之前,我們需要一個 XSLT 裡並不存在的東西——for 迴圈。
XSLT 是宣告式的,沒有命令式語言的計數迴圈。標準做法是靠模板遞迴搭配 xsl:with-param 傳遞計數值:
<?xml version="1.0" encoding="GB2312"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:copyRight="https://xml.sz.luohuedu.net/">
<!-- 以下三個變數實際應用時可由 XML 帶入,此處直接給定初始值 -->
<xsl:variable name="varStart" select="0"/> <!-- 起始值 -->
<xsl:variable name="varEnd" select="35"/> <!-- 結束值 -->
<xsl:variable name="varStep" select="2"/> <!-- 步長 -->
<xsl:template match="/">
<xsl:call-template name="MyLoopFun">
<xsl:with-param name="varStart" select="$varStart"/>
</xsl:call-template>
</xsl:template>
<xsl:template name="MyLoopFun">
<xsl:param name="varStart"/>
<xsl:if test="$varStart < $varEnd">
<a target="_blank" href="https://xml.sz.luohuedu.net/?{$varStart}">
<xsl:attribute name="title"><xsl:value-of select="$varStart"/></xsl:attribute>
<xsl:value-of select="$varStart"/>
</a>
<xsl:if test="$varStart < ($varEnd - $varStep)"> , </xsl:if>
<xsl:call-template name="MyLoopFun">
<xsl:with-param name="varStart">
<xsl:value-of select="$varStart + $varStep"/>
</xsl:with-param>
</xsl:call-template>
</xsl:if>
</xsl:template>
</xsl:stylesheet>
理解這個遞迴模式之後,最後的完整程式碼如下,註解已寫在裡頭:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="https://www.w3.org/1999/XSL/Transform"
xmlns:copyRight="https://xml.sz.luohuedu.net/">
<xsl:template match="/">
<!-- 表格列分隔用的常數,稍後以 disable-output-escaping 直接輸出 -->
<xsl:variable name="strTrLeft" select="'<tr>'"/>
<xsl:variable name="strTrRight" select="'</tr>'"/>
<!-- 總紀錄數 -->
<xsl:variable name="nTotal" select="count(/Items/Item)"/>
<!-- 表格欄數 -->
<xsl:variable name="nCols" select="3"/>
<!-- 最後一列尚需補上的格數 -->
<xsl:variable name="nLefted" select="$nCols - ($nTotal mod $nCols)"/>
<!-- 不需補齊即可湊滿整列的紀錄數 -->
<xsl:variable name="nNotProcessedRow" select="$nTotal - ($nTotal mod $nCols)"/>
<table bgcolor="snow" border="1" cellpadding="5" cellspacing="2"
borderColor="darkorange" style="font-size:9pt">
<!-- 先處理能湊滿整列的部分 -->
<xsl:for-each select="/Items/Item[position() < $nNotProcessedRow + 1]">
<xsl:if test="position() mod $nCols = 1">
<xsl:value-of select="$strTrLeft" disable-output-escaping="yes"/>
</xsl:if>
<td>
<a target="_blank">
<xsl:attribute name="href">
<xsl:if test="contains(Url,'@')">mailto:</xsl:if><xsl:value-of select="Url"/>
</xsl:attribute>
<xsl:value-of select="Title"/>
</a>
</td>
<xsl:if test="position() mod $nCols = 0">
<xsl:value-of select="$strTrRight" disable-output-escaping="yes"/>
</xsl:if>
</xsl:for-each>
<!-- 再處理最後一列,並把缺少的格子補上 -->
<xsl:if test="$nLefted != 0 and $nLefted != $nCols">
<xsl:value-of select="$strTrLeft" disable-output-escaping="yes"/>
<xsl:for-each select="/Items/Item[position() > $nNotProcessedRow]">
<td>
<a target="_blank">
<xsl:attribute name="href">
<xsl:if test="contains(Url,'@')">mailto:</xsl:if><xsl:value-of select="Url"/>
</xsl:attribute>
<xsl:value-of select="Title"/>
</a>
</td>
</xsl:for-each>
<!-- 遞迴補齊:nLefted 為待補格數,nCols 為表格欄數 -->
<xsl:call-template name="MyFun">
<xsl:with-param name="nLefted" select="$nLefted"/>
<xsl:with-param name="nCols" select="$nCols"/>
</xsl:call-template>
<xsl:value-of select="$strTrRight" disable-output-escaping="yes"/>
</xsl:if>
</table>
<p>共有<xsl:value-of select="$nTotal"/>條資料。</p>
</xsl:template>
<xsl:template name="MyFun">
<xsl:param name="nLefted"/>
<xsl:param name="nCols"/>
<xsl:if test="$nLefted != 0 and $nLefted != $nCols">
<td>
<xsl:text disable-output-escaping="yes">&nbsp;</xsl:text>
</td>
<xsl:call-template name="MyFun">
<xsl:with-param name="nLefted" select="$nLefted - 1"/>
<xsl:with-param name="nCols" select="$nCols"/>
</xsl:call-template>
</xsl:if>
</xsl:template>
</xsl:stylesheet>
由於 https://www.w3.org/1999/XSL/Transform 這套命名空間在用戶端只有 IE5.5 以上才支援,為了讓程式碼具備通用性,我們把轉換放到伺服器端進行。先建立 GoodLoop.aspx:
<%@ Page Language="vb" AutoEventWireup="false" Codebehind="GoodLoop.aspx.vb"
Inherits="ASPxWeb.mengxianhui.com.GoodLoop"%>
<%@ Import NameSpace = "System" %>
<%@ Import NameSpace = "System.Xml" %>
<%@ Import NameSpace = "System.Xml.Xsl" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>GoodLoop</title>
<script runat="server">
Sub Page_Init(ByVal sender As System.Object, ByVal e As System.EventArgs)
Try
Dim xmldom As XmlDocument = New XmlDocument()
xmldom.Load(Server.MapPath("GoodLoop.xml"))
Dim trans As XslTransform = New XslTransform()
trans.Load(Server.MapPath("GoodLoop.xsl"))
Xml1.Document = xmldom
Xml1.Transform = trans
Catch er As XmlException
Label1.Text = er.Message
End Try
End Sub
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:label id="Label1" runat="server"></asp:label>
<asp:xml id="Xml1" runat="server"></asp:xml>
</form>
</body>
</html>
本文使用的 XML 資料樣式如下(GoodLoop.xml):
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="GoodLoop1.xsl"?>
<items>
<item>
<url>https://xml.sz.luohuedu.net</url>
<title>【孟憲會之精彩世界】</title>
</item>
<item>
<url>https://lucky.myrice.com/</url>
<title>【孟憲會之精彩世界】</title>
</item>
.......................................
</items>
轉換結果如下:

歸根究柢,這個問題的關鍵在於「表格結構必須完整」這件事,資料本身反而好處理。把補齊的邏輯抽成獨立模板之後,日後要改成四欄、五欄,只需調整 nCols 一個變數即可。