三級聯動是典型的「上層決定下層」結構:選了省就載入對應的市,選了市再載入區。前端負責觸發與渲染,後端負責依上層 id 撈出下層清單。
先看一下成品:
資料庫裡必須先有對應的行政區 table,否則前端再漂亮也撈不到資料。
三個 select 依序擺放,另外用三個 hidden 欄位保存「使用者原本已選的值」,這是為了在編輯表單時能正確回填。
<tr>
<td class="tr pr10">所在地:</td>
<td class="tl">
<input type="hidden" id="myProvince" value="${user.provinceId}"/>
<input type="hidden" id="myCity" value="${user.cityId}"/>
<input type="hidden" id="myRegion" value="${user.regionId}"/>>
<select id="provinceSelect" name="user.provinceId">
<c:forEach items="${xzqhs}" var="xzqh">
<option value="${xzqh.provinceId}"
${user.regionId eq xzqh.provinceId ? "selected='selected'" : ""}>${xzqh.province}</option>
</c:forEach>
</select>
<select id="citySelect" name="user.cityId"></select>
<select id="regionSelect" name="user.regionId"></select>
</td>
<td class="gray"></td>
</tr>
// 載入市
function loadCity() {
var provinceId = $("#provinceSelect option:selected").val();
if (provinceId == null || provinceId == "") return;
$.post(rootPath + "/loadCity", { "q": provinceId }, function (data) {
if (data == "noId") { alert("請求錯誤"); return; }
if (data == "null") { alert("系統找不到屬於該省的市"); return; }
data = eval("{" + data + "}");
var citySelect = $("#citySelect");
var myCity = $("#myCity").val();
citySelect.html("");
for (var i = 0; i < data.length; i++) {
if (myCity != null && myCity != "" && myCity > 0 && myCity == data[i].id) {
citySelect.append("<option selected='selected' value='" + data[i].id + "'>" + data[i].name + "</option>");
} else {
citySelect.append("<option value='" + data[i].id + "'>" + data[i].name + "</option>");
}
}
loadRegion();
});
}
// 載入區
function loadRegion() {
var cityId = $("#citySelect option:selected").val();
if (cityId == null || cityId == "" || cityId < 1) return;
$.post(rootPath + "/loadRegion", { "q": cityId }, function (data) {
if (data == "noId") { alert("請求錯誤"); return; }
if (data == "null") { alert("系統找不到屬於該市的區"); return; }
data = eval("{" + data + "}");
var regionSelect = $("#regionSelect");
var myRegion = $("#myRegion").val();
regionSelect.html("");
for (var i = 0; i < data.length; i++) {
if (myRegion != null && myRegion != "" && myRegion > 0 && myRegion == data[i].id) {
regionSelect.append("<option selected='selected' value='" + data[i].id + "'>" + data[i].name + "</option>");
} else {
regionSelect.append("<option value='" + data[i].id + "'>" + data[i].name + "</option>");
}
}
});
}
$("#provinceSelect").change(loadCity);
$("#citySelect").change(loadRegion);
$(function () { loadCity(); });
// 載入城市資料
public void loadCity() {
if (q == null || q.trim().equals("")) {
write("noId");
} else {
List<Xzqh> citys = xzqhService.queryCitys(q.trim());
if (citys == null || citys.size() < 1) {
write("null");
} else {
StringBuilder builder = new StringBuilder("[");
for (Xzqh city : citys) {
builder.append("{'id':'").append(city.getCityId())
.append("','name':'").append(city.getCity()).append("'},");
}
if (builder.length() > 1)
builder.replace(builder.length() - 1, builder.length(), "]");
write(builder.toString());
}
}
}
// 載入區資料
public void loadRegion() {
// 結構與 loadCity 相同,改呼叫 queryDistricts 並取 regionId / region
}
後端請直接輸出 JSON。用 StringBuilder 手動組字串很容易出錯:名稱裡出現單引號就會破壞格式,中文編碼也可能出問題。請用 Jackson、Gson 等序列化函式庫,前端再用 JSON.parse 取代 eval。eval 會執行字串中的任意程式碼,用在外部回應上是明確的安全漏洞。
前端請用 DOM API 建立 option。用字串拼接 append 時,若區域名稱含有引號或角括號,就會產生畸形 HTML 甚至 XSS。改成:
data.forEach(function (item) {
var opt = new Option(item.name, item.id);
opt.selected = (String(myCity) === String(item.id));
citySelect.append(opt);
});
三級聯動不必打三次庫。行政區資料是靜態且量體固定的,一次抓完整的樹狀結構到前端,後續切換全在本機完成,既快又不受網路影響。若堅持要分次請求,請加上 debounce 避免快速切換引發請求風暴,並處理回應的順序錯亂(先發後到)。
記得無障礙與表單標籤。三個 select 都應有對應的 label,並在依賴的 select 尚未有選項時設 disabled,讓視覺與輔具使用者都能理解當前的狀態。