用 Firefox 除錯時才發現,網路上找到的 JavaScript XSLT 範例幾乎都是照 IE 的寫法在寫——ActiveXObject、transformNode,換到 Firefox 就整段失效。而現有的跨瀏覽器討論又大多繞著 AJAX 打轉,需要額外架一個後端。
如果只是想在前端把一份 XML 用 XSL 樣式表轉成畫面,其實不需要這麼麻煩。Firefox 提供了 XSLTProcessor 這個原生物件,搭配 document.implementation.createDocument 就能同步載入本機的 XML 與 XSL 檔。
transformToFragment()——把轉換結果封裝成一個文件片段,可以直接 appendChild 到頁面上的任何節點。
transformToDocument()——回傳一個完整的 XML 文件物件,需要再序列化才能塞進 innerHTML。
function initialize() {
var xmlDoc;
var xslDoc;
// 判斷瀏覽器的類型
if (document.implementation && document.implementation.createDocument) {
// 支援 Mozilla 系瀏覽器
try {
xmlDoc = document.implementation.createDocument("", "", null);
xmlDoc.async = false;
xmlDoc.load("guestbook/guestbook.xml");
} catch (e) {
alert("error:001");
}
try {
xslDoc = document.implementation.createDocument("", "", null);
xslDoc.async = false;
xslDoc.load("guestbook/guestbook.xsl");
} catch (e) {
alert("error:002");
}
try {
var xsltProcessor = new XSLTProcessor(); // 建立 XSLTProcessor
xsltProcessor.importStylesheet(xslDoc);
var oResultFragment = xsltProcessor.transformToFragment(xmlDoc, document);
// 把結果輸出到頁面
var oDiv = document.getElementById("guestbookPanel");
oDiv.appendChild(oResultFragment);
} catch (e) {
alert("error:003");
}
} else if (typeof window.ActiveXObject != 'undefined') {
// 支援 IE
xmlDoc = new ActiveXObject('Microsoft.XMLDOM');
xslDoc = new ActiveXObject('Microsoft.XMLDOM');
xmlDoc.async = false;
xslDoc.async = false;
xmlDoc.load("guestbook/guestbook.xml");
xslDoc.load("guestbook/guestbook.xsl");
guestbookPanel.innerHTML = xmlDoc.documentElement.transformNode(xslDoc);
} else {
alert("Browser unknown!");
}
}
如果偏好把結果當成字串處理,可以改用 transformToDocument,再用 XMLSerializer 序列化:
var xmlDoc;
var xslDoc;
if (document.implementation && document.implementation.createDocument) {
// 支援 Mozilla 系瀏覽器
try {
xmlDoc = document.implementation.createDocument("", "", null);
xmlDoc.async = false;
xmlDoc.load("guestbook/guestbook.xml");
xslDoc = document.implementation.createDocument("", "", null);
xslDoc.async = false;
xslDoc.load("guestbook/guestbook.xsl");
var xsltProcessor = new XSLTProcessor(); // 建立 XSLTProcessor
xsltProcessor.importStylesheet(xslDoc);
var result = xsltProcessor.transformToDocument(xmlDoc);
var xmls = new XMLSerializer();
document.getElementById("guestbookPanel").innerHTML = xmls.serializeToString(result);
} catch (e) {
alert("Unable to do xml/xsl processing");
}
} else if (typeof window.ActiveXObject != 'undefined') {
try {
// 支援 IE
xmlDoc = new ActiveXObject('Msxml2.DOMDocument');
xslDoc = new ActiveXObject('Msxml2.DOMDocument');
xmlDoc.async = false;
xslDoc.async = false;
xmlDoc.load("guestbook/guestbook.xml");
xslDoc.load("guestbook/guestbook.xsl");
guestbookPanel.innerHTML = xmlDoc.documentElement.transformNode(xslDoc);
} catch (e) {
alert("Unable to do xml/xsl processing");
}
} else {
alert("Browser unknown!");
}
async = false 是同步載入的關鍵。兩個文件物件都必須關掉非同步,否則 importStylesheet 拿到的可能還是空的樣式樹。這也意味著載入期間會阻塞執行緒,大檔案上要留意。
為什麼要分兩段 try。把 XML 與 XSL 的載入各自包起來,出錯時能立刻判斷是哪一份檔案路徑有問題,比一個大 try 包到底好除錯。
瀏覽器偵測用能力偵測更合適。範例用 document.implementation.createDocument 的有無來判斷 Mozilla 系,比查 userAgent 可靠;IE 分支則靠 window.ActiveXObject。
transformToFragment 通常比 transformToDocument 好用。前者直接回傳可插入的節點,省去序列化與重新解析這一來一回。若你確實需要字串(例如要再交給其他程式處理),才用 transformToDocument 搭配 XMLSerializer。
最後補一句現實情況:這套寫法所針對的 IE 與舊版 Firefox 環境如今已不復存在,而 document.load()、ActiveXObject 也都早已從標準中移除。今天要在瀏覽器端做 XML/XSLT 轉換,比較可行的方向是引入 JavaScript 的 XSLT 實作函式庫,或者乾脆在伺服器端完成轉換再把 HTML 送到前端。這份程式碼的價值在於示範兩種瀏覽器家族在 DOM 與轉換 API 上的設計分歧,以及用能力偵測把它們包在同一支程式裡的思路。