DIV CSS 佈局教程網

省市區三級聯動下拉選單:前端 Ajax 串接與後端資料組裝
編輯:關於JavaScript     

三級聯動是典型的「上層決定下層」結構:選了省就載入對應的市,選了市再載入區。前端負責觸發與渲染,後端負責依上層 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>

前端 JavaScript

// 載入市
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,讓視覺與輔具使用者都能理解當前的狀態。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved