本文以一個實際的登入設定檔為例,示範如何在瀏覽器端用 JavaScript 讀取 XML 資料,並依個人理解重新整理說明。
假設我們有一支 Login.xml,用來存放角色、武器與配點等可選項:
<?xml version="1.0" encoding="utf-8" ?>
<Login>
<Character>
<C Text="熱血" Value="0" />
<C Text="弱氣" Value="1" />
<C Text="激情" Value="2" />
<C Text="冷靜" Value="3" />
<C Text="冷酷" Value="4" />
</Character>
<Weapon>
<W Text="光束劍" Value="0" />
<W Text="光束配刀" Value="1" />
</Weapon>
<EconomyProperty>
<P Text="平均型" Value="0" />
<P Text="重視攻擊" Value="1" />
<P Text="重視敏捷" Value="2" />
<P Text="重視防御" Value="3" />
<P Text="重視命中" Value="4" />
</EconomyProperty>
</Login>
瀏覽器端讀取 XML 要透過 XMLDOM 物件,而各家實作不同,得先做能力偵測:
loadXML = function(xmlFile) {
var xmlDoc;
if (window.ActiveXObject) {
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 走 ActiveXObject 這條路,並把 async 設為 false 以確保同步讀取;具備 DOM Level 2 的瀏覽器則用 createDocument。兩者皆不可用時回傳 null。
直接呼叫載入函式風險不小,建議包一層:
checkXMLDocObj = function(xmlFile) {
var xmlDoc = loadXML(xmlFile);
if (xmlDoc == null) {
alert('您的瀏覽器不支援 XML 讀取,本頁面已限制操作,建議改用 IE5.0 以上版本。');
window.location.href = '/Index.aspx';
}
return xmlDoc;
}
文件物件到手後,就能開始查詢。例如要取 Login/Weapon/W 的第一個節點的 Text 屬性:
var xmlDoc = checkXMLDocObj('/EBS/XML/Login.xml');
var v = xmlDoc.getElementsByTagName('Login/Weapon/W')[0].childNodes.getAttribute('Text');
寫法上有個容易忽略的細節:getElementsByTagName 不接受完整的 XPath 路徑,跨層級查詢時建議分層取得,或改用 selectNodes 搭配真正的 XPath,這在實務上會穩定得多。
以下是我實際用在專案裡的寫法,一併提供參考:
initializeSelect = function(oid, xPath) {
var xmlDoc = checkXMLDocObj('/EBS/XML/Login.xml');
var n, l;
var e = $(oid);
if (e != null) {
n = xmlDoc.getElementsByTagName(xPath)[0].childNodes;
l = n.length;
for (var i = 0; i < l; i++) {
// 逐筆建立 option,把 Text 當顯示文字、Value 當實際值
var opt = document.createElement('option');
opt.text = n[i].getAttribute('Text');
opt.value = n[i].getAttribute('Value');
e.options.add(opt);
}
}
}
核心思路是:先確認目標元素存在,再取出指定節點下的所有子節點,最後遍歷建立 option。這樣一來,所有需要下拉選單的欄位都能共用同一份設定檔,改選項時不必動到程式碼。
用 XML 驅動表單選項,優點是資料與邏輯分離、維護成本低;缺點是同步讀檔會阻塞、且各家瀏覽器實作不一。在現代專案中,同樣的需求多半會改用 JSON 搭配 fetch 或 XHR 來完成,但理解 XMLDOM 的操作邏輯,仍有助於維護這類老系統。