過去做省市連動,多是把資料寫在 JavaScript 陣列裡。但實務上更常見的需求是資料來自資料庫——城市可能隨時增刪,寫死在前端遲早出問題。這時就該改用非同步提交、局部刷新的思路。以下示範以 XML 作為資料格式的作法。
這段程式碼是通用的,放在函式外即可供所有函式共用:
var xhr = false;
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else if (window.ActiveXObject) {
xhr = new ActiveXObject("Microsoft.XMLHTTP");
} else {
xhr = false;
}
function getCity() {
var provinceobj = document.getElementById("province");
var index = provinceobj.selectedIndex;
var provincevalue = provinceobj[index].value; // 省份的 value
// var province = provinceobj[index].text; // 省份顯示文字
var url = "<%=basepath%>CityServlet";
// 若用 get,參數直接接在 url 後:
// var url = "<%=basepath%>CityServlet?provincevalue=" + provincevalue;
xhr.open("post", url, true); // true 表示非同步
// post 提交時需指定編碼,否則後端可能收到亂碼
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
// 綁定狀態變化時的回呼
xhr.onreadystatechange = callBack_XML;
// post 的資料要放在 send 裡
xhr.send("provincevalue=" + provincevalue);
}
順帶一提,中文值若直接接在 URL 後以 get 送出,務必先 encodeURIComponent(),否則編碼不一致時後端會拿到亂碼。這也是多數人偏好用 post 的原因。
function callBack_XML() {
var cityobj = document.getElementById("city");
// 4 代表回應已完成,可以使用
if (xhr.readyState == 4) {
if (xhr.status == 200) {
// 取得 XML 文件
var cityxml = xhr.responseXML;
var root = cityxml.documentElement;
var cities = root.getElementsByTagName("city");
// 清空城市下拉選單,保留第一個提示項
cityobj.options.length = 1;
for (var i = 0; i < cities.length; i++) {
var city = cities[i];
var cid = city.childNodes[0].firstChild.nodeValue;
var cname = city.childNodes[2].firstChild.nodeValue;
// new Option(顯示文字, 值)
cityobj.options[cityobj.options.length] = new Option(cname, cid);
}
} else if (xhr.status == 404) {
alert("找不到請求的網址!");
} else {
alert("發生錯誤,狀態碼:" + xhr.status);
}
}
}
這裡用 childNodes[索引] 取值,其實相当脆弱:瀏覽器會把標籤之間的換行與縮排也計為文字節點,導致索引錯位。更穩健的寫法是改用 childNodes 前先以 getElementsByTagName("id")[0] 精準定位,或直接改用 JSON 這種不必解析節點的格式。
String provincevalue = request.getParameter("provincevalue");
CityService cityservice = CityService.getCityService();
List<City> citylist = cityservice.getCity(provincevalue);
StringBuffer xml = new StringBuffer();
xml.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>");
xml.append("<city_info>");
for (City c : citylist) {
xml.append("<city>");
xml.append("<id>" + c.getId() + "</id>");
xml.append("<cityid>" + c.getCityid() + "</cityid>");
xml.append("<cityname>" + c.getCity() + "</cityname>");
xml.append("<province>" + c.getFather() + "</province>");
xml.append("</city>");
}
xml.append("</city_info>");
// 設定編碼,避免中文亂碼
response.setCharacterEncoding("utf-8");
response.setContentType("text/xml;charset=utf-8");
PrintWriter writer = response.getWriter();
writer.write(xml.toString());
writer.flush();
writer.close();
一、XML 拼接未做跳脫。城市名稱若含 &、< 等字元,會直接破壞文件結構。請改用既有的 XML 函式庫產生文件,讓跳脫交給函式庫處理。
二、回應標頭建議加上 Cache-Control: no-cache。某些瀏覽器會快取 XHR 的 GET 回應,導致切換省份後城市清單沒更新。加上禁止快取的標頭,或在 URL 附帶隨機參數,都能避免這個經典問題。
以 XML 實作二級連動的重點不在語法,而在三件事:編碼一致、禁止快取、以及節點定位要穩健。若專案沒有對接既有 XML 服務的壓力,改用 JSON 會省下大量解析程式碼——伺服器端 json_encode(),客戶端 JSON.parse(),城市清單就是一個陣列,迴圈一跑即完成。