DIV CSS 佈局教程網

下拉選單聯動該怎麼做?Ajax 非同步載入與 Result 封裝的實踐
編輯:AJAX基礎知識     

設備類別與設備子類、國家與城市、省份與縣市——這類「上一層決定下一層」的選單聯動幾乎每個後台都會遇到。實作路線大致兩條,本文說明各自的適用時機,並示範以 Ajax 動態載入的完整做法。

兩種思路的取捨

做法一:把整份資料放在前端

頁面載入時一次取回所有聯動資料,用多維陣列或嵌套物件存放,選擇時直接從中篩選。優點是零延遲、不需反覆請求;缺點是資料量大時首屏變重,且資料更新後頁面必須重載。

做法二:Ajax 非同步動態載入

選擇上一層時才向後台索取下一層選項。程式碼直觀、資料新鮮、傳輸量小,是開發首選。以下示範這種做法。

一、頁面結構

<div class="form-group">
  <label class="col-sm-2 control-label">設備類別</label>
  <div class="col-sm-4">
    <select class="basic-single" name="codeCategory"
            onchange="showCodeSubCate()" id="codeCategory" style="width: 100%">
    </select>
  </div>

  <label class="col-sm-2 control-label">設備子類</label>
  <div class="col-sm-4">
    <select class="basic-single" name="codeSubCategory"
            id="codeSubCate" disabled="disabled" style="width: 100%">
      <option value="">--請選擇--</option>
    </select>
  </div>
</div>

一級選單在頁面載入時填入;二級選單初始為 disabled,等一級選好才解鎖,這樣使用者不會誤點到空清單。

二、前端 Ajax

// 載入一級:設備類別
function addCodeCategory(){
    $.ajax({
        url: "<%=request.getContextPath()%>/facilitydict/showCodeCategory",
        type: "GET",
        success: function(result) {
            result = $.parseJSON(result);
            var codeCates = result.data.split(",");
            var str = '<option value="6801">--請選擇--</option>';
            for (x in codeCates) {
                str += '<option value="' + codeCates[x] + '">' + codeCates[x] + '</option>';
            }
            $("#codeCategory").html(str);
        }
    });
}

// 一級變動 → 載入二級
function showCodeSubCate(){
    $("#codeSubCate").prop("disabled", "");   // 解鎖二級選單

    var target = $("#codeCategory option:selected").text();
    $.ajax({
        url: "<%=request.getContextPath()%>/facilitydict/showCodeSubCategory",
        data: { codeCategory: target },
        type: "GET",
        success: function(result) {
            result = $.parseJSON(result);
            var codeCates = result.data.split(",");
            var str = "";
            for (x in codeCates) {
                str += '<option value="' + codeCates[x] + '">' + codeCates[x] + '</option>';
            }
            $("#codeSubCate").html(str);
        }
    });
}

流程很單純:一級選單變動觸發 showCodeSubCate(),請求後台取得子類清單,再塞進二級 select。

三、後台 Controller

@RequestMapping("/showCodeCategory")
@ResponseBody
public Result<String> searchCodeCategory() {
    Result<String> rs = new Result<>();
    List<String> codeCategorys = facilityDictService.searchCodeCategory();
    rs.setData(StringUtil.collectionToCommaDelimitedString(codeCategorys));
    return rs;
}

@RequestMapping("/showCodeSubCategory")
@ResponseBody
public Result<String> searchCodeSubCategory(HttpServletRequest request) {
    String codeCategory = request.getParameter("codeCategory");
    Result<String> rs = new Result<>();
    List<String> codeSubCategorys = facilityDictService.searchCodeSubCategory(codeCategory);
    rs.setData(StringUtil.collectionToCommaDelimitedString(codeSubCategorys));
    return rs;
}

四、Result 泛型封裝

後台回傳統一包成 Result,前台只需判斷一個 success 旗標,不必針對每個介面寫不同解析:

public class Result<T> implements Serializable {
    private static final long serialVersionUID = 3637122497350396679L;

    private boolean success;
    private T data;
    private String msg;

    public Result() {}

    public Result(boolean success) { this.success = success; }

    public Result(boolean success, String msg) {
        this.success = success;
        this.msg = msg;
    }

    public Result(boolean success, T data) {
        this.success = success;
        this.data = data;
    }

    public boolean isSuccess()                 { return success; }
    public void setSuccess(boolean success)    { this.success = success; }
    public T getData()                         { return data; }
    public void setData(T data)                { this.data = data; }
    public String getMsg()                     { return msg; }
    public void setMsg(String msg)             { this.msg = msg; }
}

有了統一結構,一般的增刪改查也都能共用同一套前台處理:

$.ajax({
    url: "<%=request.getContextPath()%>/supp/deleteSupp",
    data: { supplierId: supplierId },
    type: "GET",
    success: function(data) {
        var rs = eval('(' + data + ')');
        if (rs.success) {
            alert("刪除成功!");
        } else {
            alert(rs.msg);
        }
    }
});
@RequestMapping("/deleteSupp")
@ResponseBody
public Result<String> deleteSupplier(HttpServletRequest request) {
    Result<String> rs = new Result<>();
    String supplierId = request.getParameter("supplierId");
    supplierService.deleteSupplierById(supplierId);
    rs.setSuccess(true);
    return rs;
}

實務上值得修正的幾處

  • 用逗号字串傳清單並不理想:split(",") 一旦遇到值本身含逗號就會裂開。建議直接回傳 JSON 陣列,前台用 $.map() 處理。
  • 別用 eval 解析 JSON:eval('(' + data + ')') 應改為 JSON.parse(data),或為 ajax 指定 dataType: 'json' 讓 jQuery 自動解析。
  • async: false 應避免:同步請求會凍結整個頁面。若擔心使用者連點造成錯亂,改用非同步並在請求期間 disable 二級選單即可。
  • 一級重選時要清空二級:範例切換類別時直接覆寫 html,這是對的;但要留意若 previous 請求尚未返回,可能出現舊資料蓋掉新資料的「回應亂序」問題,可用請求序號或 AbortController 取消前一次。
  • 用 for...in 遍歷陣列不安全:for (x in codeCates) 會把 Array.prototype 上被擴充的屬性也算進來,改用 for (let i = 0; ...) 或 forEach。
  • 可考慮一次載入:設備類別這種字典資料通常量小且變動少,一次撈回前端快取反而更快,也能完全避免回應亂序。

以上就是下拉選單聯動的完整實作與檢討,希望對你的學習有所幫助。

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