早期 Web 開發裡,XML 是資料交換與設定檔的主力格式。瀏覽器端要讀 XML,核心只有兩件事:把 XML 變成一個 DOM 文件物件,然後用 DOM 的方法去取值。本文把載入檔案、解析字串、遍歷節點這幾段常用邏輯整理在一起。
<?xml version="1.0" encoding="utf-8" ?>
<Login>
<Character>
<C Text="熱血" Value="0"></C>
<C Text="弱氣" Value="1"></C>
<C Text="激情" Value="2"></C>
<C Text="冷靜" Value="3"></C>
<C Text="冷酷" Value="4"></C>
</Character>
<Weapon>
<W Text="光束劍" Value="0"></W>
<W Text="光束配刀" Value="1"></W>
</Weapon>
<EconomyProperty>
<P Text="平均型" Value="0"></P>
<P Text="重視攻擊" Value="1"></P>
<P Text="重視敏捷" Value="2"></P>
<P Text="重視防御" Value="3"></P>
<P Text="重視命中" Value="4"></P>
</EconomyProperty>
</Login>
瀏覽器並沒有統一的 XML 載入方式,需要分舊版 IE 與標準瀏覽器兩條路走:
loadXML = function (xmlFile) {
var xmlDoc;
if (window.ActiveXObject) {
// 舊版 IE 走 ActiveX
xmlDoc = new ActiveXObject('Microsoft.XMLDOM');
xmlDoc.async = false;
xmlDoc.load(xmlFile);
} else if (document.implementation && document.implementation.createDocument) {
xmlDoc = document.implementation.createDocument('', '', null);
xmlDoc.load(xmlFile);
} else {
return null;
}
return xmlDoc;
};
更穩妥的 IE 寫法是按版本依序嘗試,避免機器上沒註冊指定版本時直接失敗:
loadXML = function (xmlFile) {
var xmlDoc = null;
if (!window.DOMParser && window.ActiveXObject) {
var versions = ['MSXML.2.DOMDocument.6.0', 'MSXML.2.DOMDocument.3.0', 'Microsoft.XMLDOM'];
for (var i = 0; i < versions.length; i++) {
try { xmlDoc = new ActiveXObject(versions[i]); break; } catch (e) { }
}
} else if (document.implementation && document.implementation.createDocument) {
// createDocument 的三個參數依次為:命名空間 URI、根元素名稱、文件類型
xmlDoc = document.implementation.createDocument('', '', null);
} else {
return null;
}
if (xmlDoc != null) {
xmlDoc.async = false; // 同步載入,確保取值時文檔已就緒
xmlDoc.load(xmlFile);
}
return xmlDoc;
};
拿到文件物件後,取值就是普通的 DOM 操作。實務上建議先做一次物件檢查,載入失敗時給出提示而不是讓整頁腳本中斷:
checkXMLDocObj = function (xmlFile) {
var xmlDoc = loadXML(xmlFile);
if (xmlDoc == null) {
alert('您的瀏覽器不支援 XML 檔案讀取,推薦使用 IE5.0 以上版本');
window.location.href = '/Index.aspx';
}
return xmlDoc;
};
var xmlDoc = checkXMLDocObj('/EBS/XML/Login.xml');
var v = xmlDoc.getElementsByTagName('Login/Weapon/W')[0].childNodes.getAttribute('Text');
也可以走 documentElement 一層層往下:
xmlDoc.documentElement.childNodes(1).childNodes(0).getAttribute('Text');
把 XML 當設定檔,最常見的用法就是產生 option:
initializeSelect = function (oid, xPath) {
var xmlDoc = checkXMLDocObj('/EBS/XML/Login.xml');
var e = $(oid);
if (e != null) {
var n = xmlDoc.getElementsByTagName(xPath)[0].childNodes;
for (var i = 0; i < n.length; i++) {
var option = document.createElement('option');
option.value = n[i].getAttribute('Value');
option.innerHTML = n[i].getAttribute('Text');
e.appendChild(option);
}
}
};
nodeName:取得節點名稱。nodeValue:取得節點的值,例如 <a>b</a> 會得到 b。hasChild():判斷是否有子節點。getElementsByTagName(xPath):直接用路徑定位,程式碼最乾淨,效能也好,是我個人最推薦的方式。如果資料不是來自檔案,而是一段字串(例如 AJAX 回應),做法略有不同:IE 用 loadXML(),標準瀏覽器用 DOMParser。
loadXML = function (xmlString) {
var xmlDoc = null;
if (!window.DOMParser && window.ActiveXObject) {
var versions = ['MSXML.2.DOMDocument.6.0', 'MSXML.2.DOMDocument.3.0', 'Microsoft.XMLDOM'];
for (var i = 0; i < versions.length; i++) {
try {
xmlDoc = new ActiveXObject(versions[i]);
xmlDoc.async = false;
xmlDoc.loadXML(xmlString); // 字串用 loadXML
break;
} catch (e) { }
}
} else if (window.DOMParser && document.implementation && document.implementation.createDocument) {
try {
// parseFromString(text, contentType)
// contentType 可取 "text/xml"、"application/xml" 或 "application/xhtml+xml",不支援 "text/html"
var domParser = new DOMParser();
xmlDoc = domParser.parseFromString(xmlString, 'text/xml');
} catch (e) { }
} else {
return null;
}
return xmlDoc;
};
<?xml version="1.0" encoding="utf-8" ?> <DongFang> <Company><cNname>1</cNname><cIP>1</cIP></Company> <Company><cNname>2</cNname><cIP>2</cIP></Company> <Company><cNname>3</cNname><cIP>3</cIP></Company> </DongFang>
var xmldoc = loadXML('text.xml');
var elements = xmldoc.getElementsByTagName("Company");
for (var i = 0; i < elements.length; i++) {
var name = elements[i].getElementsByTagName("cNname")[0].firstChild.nodeValue;
var ip = elements[i].getElementsByTagName("cIP")[0].firstChild.nodeValue;
}
最後提醒一個實務上的相容性細節:xmlDoc.async = false 要寫成布林值,寫成字串 "false" 在 Firefox 下會報錯。