DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 AjaxPro 打造四級無刷新聯動下拉選單
編輯:AJAX詳解     

開發環境:Visual Studio 2005、C#、Oracle、AjaxPro。

設計取捨:哪些資料放前端,哪些放後端

四級聯動(省 → 市 → 縣區 → 鎮)若每一層都回伺服器問一次,壓力與延遲都很可觀。這裡的做法是依資料特性分流:

  • 省與市兩級寫成 JavaScript 陣列。這兩層變動頻率低、資料量固定,放在前端可以完全免除請求。
  • 縣區與鎮兩級存在 Oracle 裡。資料量大得多,透過 JavaScript 觸發 C# 去讀資料庫,把結果回傳後再綁定顯示。

操作 <select> 時刻意採用更通用的 createElement() 而非 options.add(),相容性較好。

頁面結構

<table>
  <tr>
    <td><select id="SF"><option selected="selected">—請選擇—</option></select></td>
    <td><select id="CS"><option selected="selected">—請選擇—</option></select></td>
    <td><select id="Xian"><option selected="selected">—請選擇—</option></select></td>
    <td><select id="Zhen"><option selected="selected">—請選擇—</option></select></td>
  </tr>
</table>

前端資料陣列

每筆資料四個欄位:行政區代碼、名稱、上層代碼、拼音代碼。前兩級的上層代碼統一為 "0",第三、四級則指向其父層的代碼:

var aDQ = new Array();
aDQ[0]  = ["11", "北京", "0", "bj"];
aDQ[1]  = ["12", "天津", "0", "tj"];
aDQ[2]  = ["13", "河北", "0", "hb"];
// ... 其餘各省、直轄市、自治區依此類推
aDQ[34] = ["1101", "北京城區", "11", "bjcq"];
aDQ[35] = ["1102", "北京縣區", "11", "bjxq"];
aDQ[38] = ["1301", "石家莊", "13", "sjz"];
aDQ[39] = ["1302", "唐山", "13", "hbts"];
// ... 共三百餘筆,涵蓋各縣市、港澳與台灣地區

核心函式:用 DOM 動態組出選項

// obj:選項資料來源,可能是 Array 或 DataTable
// id:目標下拉選單的 id
function CreateDropDownList(obj, id) {
    var sel = document.getElementById(id);
    sel.options.length = 1;   // 保留「—請選擇—」

    if (obj == null) return;

    if (obj instanceof Array) {
        // 省、市兩級走這裡
        for (var i = 0; i < obj.length; i++) {
            var op = document.createElement("option");
            op.setAttribute("value", obj[i][0]);
            op.appendChild(document.createTextNode(obj[i][1]));
            sel.appendChild(op);
        }
    } else {
        // 縣、鎮兩級走這裡,資料來自 C# 回傳的 DataTable
        for (var i = 0; i < obj.Rows.length; i++) {   // 注意是 length,不是 Count
            var op = document.createElement("option");
            op.setAttribute("value", obj.Rows[i].ID);    // 注意大小寫
            op.appendChild(document.createTextNode(obj.Rows[i].NAME));
            sel.appendChild(op);
        }
    }

    // 綁定下一層的行為
    switch (id) {
        case "SF":
            sel.onchange = function() {
                ClearXianZhen();
                CreateDropDownList(GetArray(this.value), "CS");
            };
            break;
        case "CS":
            sel.onchange = function() {
                ClearZhen();
                CreateDropDownList(Area.GetDataTable(this.value, AreaEnum.Xian).value, "Xian");
            };
            break;   // JS 呼叫 C# 方法並取得回傳值
        case "Xian":
            sel.onchange = function() {
                CreateDropDownList(Area.GetDataTable(this.value, AreaEnum.Zhen).value, "Zhen");
            };
            break;
        default:
            sel.onchange = function() { alert(this.value); };
    }
}

三個輔助函式:

// 從 aDQ 中篩出指定上層底下的所有項目
function GetArray(val) {
    var temp = new Array();
    var j = 0;
    for (var i = 0; i < aDQ.length; i++) {
        if (aDQ[i][2].toString() == val) {
            temp[j] = aDQ[i];
            j++;
        }
    }
    return temp;
}

function ClearZhen() {
    CreateDropDownList(null, "Zhen");
}

function ClearXianZhen() {
    CreateDropDownList(null, "Xian");
    CreateDropDownList(null, "Zhen");
}

// 執行入口
CreateDropDownList(GetArray("0"), "SF");

伺服器端:C# 與 AjaxPro 註冊

using System;
using System.Data;
using System.Data.OracleClient;

public partial class Area : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        // 把類別與列舉型別註冊到 JavaScript 端
        AjaxPro.Utility.RegisterTypeForAJax(typeof(Area));
        AjaxPro.Utility.RegisterEnumForAJax(typeof(AreaEnum));
    }

    /// <summary>
    /// 取得下拉選單所需的資料
    /// </summary>
    [AjaxPro.AjaxMethod]
    public DataTable GetDataTable(string UpID, AreaEnum ae)
    {
        if (String.IsNullOrEmpty(UpID))
            return null;

        string link = "server=XXX;user=XXX;pwd=XXX;";
        OracleConnection conn = new OracleConnection(link);

        string sql;
        if (Enum.Equals(ae, AreaEnum.Xian))
            sql = "SELECT id,name FROM City WHERE THREEID=0 AND TWOID=" + UpID;
        else
            sql = "SELECT id,name FROM City WHERE THREEID=" + UpID;

        OracleDataAdapter adapter = new OracleDataAdapter(sql, conn);
        DataTable table = new DataTable();
        adapter.Fill(table);
        return table;
    }
}

public enum AreaEnum
{
    /// <summary>縣</summary>
    Xian,
    /// <summary>鎮</summary>
    Zhen
}

Web.config 設定

別忘了在 <system.web> 中註冊 AjaxPro 的 handler,否則前端呼叫會直接 404:

<httpHandlers>
  <add verb="POST,GET" path="ajaxpro/*.ashx"
       type="AjaxPro.AjaxHandlerFactory, AjaxPro.2" />
</httpHandlers>

踩過的坑與實務提醒

  • Oracle 回傳的欄位名全是大寫。前端取值時 obj.Rows[i].ID 的大小寫必須與 DataTable 的欄位名一致,這是最常見的「資料明明有卻抓不到」的原因。
  • 用 length 而非 Count。JavaScript 陣列與 .NET 的集合在這裡的介面不同,AjaxPro 序列化後要用 .Rows.length。
  • SQL 應改用參數化查詢。範例中把 UpID 直接串進 SQL 只是為了示範;正式環境請改用 OracleParameter,否則等於把注入的門開著。
  • 連線物件該明確釋放。範例未包在 using 中,實務上應以 using 區塊管理 OracleConnection 與 OracleDataAdapter,避免連線洩漏。
  • 使用者快速切換時會產生大量請求。可考慮加入 debounce 或快取已查詢過的結果,特別是同一層級被反覆切換時。

核心功能到此完成。若還想延伸,可以做的還有:依網域或 IP 自動判定所在地區並直接綁定、記住使用者上次的選擇、把這組邏輯抽成可重複使用的控制項等等。

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