閑著沒事,把專案裡常要用的「依 ID 取城市/省份/地區名稱」這件事整理成一個類別,以後直接呼叫即可。
作法是用 MSXML 的 DOMDocument 載入對應的 XML 檔,再用 selectNodes 取出節點集合,逐一比對屬性值,命中就輸出名稱。
頁面中的呼叫方式:
<script language="Javascript">
GetCityName("<%=cityid%>", "<%=System.Configuration.ConfigurationSettings.AppSettings["LocalSiteURL"]%>")
</script>
function GetCityName(cityid, xmlurl)
{
var xmlDocCity = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDocCity.async = false;
xmlDocCity.validateOnParse = false;
var url = xmlurl + "XmlData/city.xml";
xmlDocCity.load(url);
if (xmlDocCity.readyState == 4 && xmlDocCity.xml != "")
{
var cities = xmlDocCity.documentElement.selectNodes("city");
for (var i = 0; i < cities.length; i++)
{
var city = cities[i];
if (city.getAttribute("cityid") == cityid)
{
document.write(city.getAttribute("cityname"));
break;
}
}
}
}
function GetProvinceName(pid, xmlurl)
{
var xmlDoc = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDoc.async = false;
xmlDoc.validateOnParse = false;
var url = xmlurl + "XmlData/province.xml";
xmlDoc.load(url);
if (xmlDoc.readyState == 4 && xmlDoc.xml != "")
{
var provinces = xmlDoc.documentElement.selectNodes("province");
for (var i = 0; i < provinces.length; i++)
{
var province = provinces[i];
if (province.getAttribute("provinceid") == pid)
{
document.write(province.getAttribute("provincename"));
break;
}
}
}
}
function GetDistrictName(districtid, xmlurl)
{
var xmlDoc = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDoc.async = false;
xmlDoc.validateOnParse = false;
var url = xmlurl + "XmlData/district.xml";
xmlDoc.load(url);
if (xmlDoc.readyState == 4 && xmlDoc.xml != "")
{
var districts = xmlDoc.documentElement.selectNodes("district");
for (var i = 0; i < districts.length; i++)
{
var district = districts[i];
if (district.getAttribute("districtid") == districtid)
{
document.write(district.getAttribute("districtname"));
break;
}
}
}
}
實務上更常用的是一次組出「省 市 區」三段文字。這裡同時載入三份 XML 分別查詢,再拼接起來:
function GetName(pid, cityid, districtid, xmlurl)
{
var cityname = "";
var provincename = "";
var districtname = "";
// 載入省份
var xmlDocP = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDocP.async = false;
xmlDocP.validateOnParse = false;
xmlDocP.load(xmlurl + "XmlData/province.xml");
// 載入城市
var xmlDocCity = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDocCity.async = false;
xmlDocCity.validateOnParse = false;
xmlDocCity.load(xmlurl + "XmlData/city.xml");
// 載入地區
var xmlDocDistrict = new ActiveXObject("MSXML2.DOMDocument.3.0");
xmlDocDistrict.async = false;
xmlDocDistrict.validateOnParse = false;
xmlDocDistrict.load(xmlurl + "XmlData/district.xml");
if (xmlDocP.readyState == 4 && xmlDocP.xml != "")
{
var provinces = xmlDocP.documentElement.selectNodes("province");
for (var i = 0; i < provinces.length; i++)
{
if (provinces[i].getAttribute("provinceid") == pid)
{
provincename = provinces[i].getAttribute("provincename");
break;
}
}
}
if (xmlDocCity.readyState == 4 && xmlDocCity.xml != "")
{
var cities = xmlDocCity.documentElement.selectNodes("city");
for (var i = 0; i < cities.length; i++)
{
if (cities[i].getAttribute("cityid") == cityid)
{
cityname = cities[i].getAttribute("cityname");
break;
}
}
}
if (xmlDocDistrict.readyState == 4 && xmlDocDistrict.xml != "")
{
var districts = xmlDocDistrict.documentElement.selectNodes("district");
for (var i = 0; i < districts.length; i++)
{
if (districts[i].getAttribute("districtid") == districtid)
{
districtname = districts[i].getAttribute("districtname");
break;
}
}
}
document.write(provincename + " " + cityname + " " + districtname);
}
這份程式碼能用,但若要正式上線,有幾處值得調整。
用 XPath 取代迴圈比對:三段 for 迴圈其實都可以濃縮成一句。selectNodes 本身就吃 XPath,所以整個查詢可以寫成 xmlDoc.selectSingleNode("province[@provinceid='" + pid + "']"),程式碼短得多,效率也更好。不過要注意:若 id 來自使用者輸入,拼接字串前必須先做驗證或轉義,否則有 XPath 注入的風險。
別用 document.write:document.write 在頁面載入完成後呼叫會清空整個文件。改成設定某個元素的 innerHTML 或 textContent 才是恰當做法。同時,寫入字串若含不可信內容,應先轉義以免造成 XSS。
ActiveX 綁定 IE:MSXML2.DOMDocument 是 IE 專屬途徑,其他瀏覽器完全無法使用。跨瀏覽器方案應改用 fetch 搭配 DOMParser。
同步載入的代價:async = false 會凍結瀏覽器直到 XML 下載完成。一次要載三份檔的話,使用者會明顯感覺到卡頓。改為非同步並用 Promise 串接才是正確方向。
最後一點或許才是根本:靜態的三段行政區對照表放在 XML 裡、由前端逐次載入查詢,本身就是個值得重新思考的設計。若資料量不大,直接輸出成 JavaScript 物件或 JSON 讓前端一次載入並建索引,會比反覆解析 XML 划算得多;若資料量大或需要即時性,就該由伺服器端提供查詢介面了。