一次無意間看到某個部落格的 RSS 能用 XSL 格式輸出,還能在 Firefox 中正常瀏覽,這讓我想起自己以前寫過的一個 XML 留言簿——當年正因為無法相容 Firefox 而擱置。出於好奇,我逐行比對那段程式碼,最後終於找到了問題癥結,也順勢把這個留言簿完成了。由於結構簡單,便取名為 SXGB(Simple XML GuestBook)。
身為一個留言簿,內容不必太複雜。我把留言劃分為三部分:留言者姓名、留言者主頁與留言內容;此外還需要使用者資訊(用戶名、主頁)以及分頁資訊。整體結構大致完成後,就可以著手撰寫 XML 文檔模板了。
XML 文檔的根元素定義為 gbook,其下包含 info(留言簿相關資訊,如用戶名、主頁、當前頁、總頁數、上下頁、是否登陸)與 messages(留言列表,每則 message 含 id、username、time、homepage、content)。
一個關鍵細節:引用 XSL 時,XML 與 stylesheet 之間必須使用連字號(-)而非冒號(:),因為 Firefox 並不支持冒號寫法。
好的 XML 文檔除了要有結構性,還應該具備有效性。因此在文檔開頭就定義了 DTD(sxgb.dtd)。由於結構已經設計妥當,撰寫 DTD 便得心應手。這裡有個實務上的考量:<!ELEMENT messages (message+)> 中的「+」代表至少有一則留言,但實際上可能出現零留言的情況,對此我在輸出的 ASP 程式裡會動態產生一則系統提示訊息來因應。
XSL 的核心概念是「模板」,每個模板對應一塊內容的格式化輸出。建構模板時可以從大到小(先全域再細分),也可以從小到大(先細分再組合)。定義名稱空間時,務必使用 https://www.w3.org/1999/XSL/Transform,若誤用舊版的 WD-xsl,Firefox 會直接報「分析 XSLT 樣式表單失敗」。
套用模板有兩種方式:直接套用(<xsl:apply-templates>)與循環選擇(<xsl:for-each>)。此外常用的標記還包括 <xsl:value-of>(輸出節點值)、<xsl:attribute>(動態添加屬性)與 <xsl:if>(條件判斷)。特別提醒:在 <xsl:if> 中判斷「小於」時,不能直接用「<」,而必須寫成「<」,否則會引發瀏覽器錯誤。
ASP 的部分,只要按照前面定義的格式,從資料庫讀取記錄並依模板輸出即可。兩個關鍵設定不可少:一是 Response.ContentType="application/XML",宣告這是一份 XML 文檔;二是因為全程採用 UTF-8 編碼,需在檔案開頭加上 CodePage="65001"。
最後再搭配 CSS 定義視覺效果,並在客戶端加入一段 JavaScript 檢查表單是否為空,避免使用者誤提交空留言。至此,一個跨瀏覽器、結構清晰的 XML 留言簿便大功告成。