DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
原創通用組合查詢器(續):Ajax 客戶端腳本與查詢頁完整實作
編輯:AJAX詳解     

上一篇把伺服器端的中介資料準備好了——哪些欄位可以查、每個欄位適用哪些運算子、哪些欄位有固定的列舉值。這一篇要動手的是使用者真正看得到的那一半:一個能在瀏覽器裡動態長出條件列、依欄位型別自動切成文字框或下拉選單,最後把整串條件拼裝成查詢片段的查詢面板。

一、AJaxSearchClientScript.js:條件列的誕生與維護

整個腳本圍繞幾個全域變數運作:tbPanel 指向承載條件列的表格控制項,tableName 記住目前查詢的資料表,fieldsInfo 快取第一次向伺服器取回的欄位定義(後續就不再重複請求是關鍵設計),no 則是自我遞增的計數器,用來確保動態產生的 DOM 元素 id 不會互相打結。

addTerm:一次生出六個格子

新增一列時,腳本依序完成六件事:

  1. 插入欄位選擇下拉選單,選項來自伺服器端以「中文名|欄位名」格式回傳的陣列,以 | 切開後分別當成顯示文字與值。
  2. 建立運算子下拉選單,內容由 GetOpts 依當前欄位型別決定。
  3. 建立條件值的輸入區,由 getInput 依型別動態產生。
  4. 建立「並且/或者」的連接條件下拉選單(值分別為 And、Or)。
  5. 建立「刪除」按鈕,綁定 DelRow。
  6. 建立「新增」按鈕,綁定 addRow。
function addTerm(tbPanelId) {
    tbPanel = document.getElementById(tbPanelId);
    if (tableName == null) tableName = document.getElementById("transValue").value;

    var row = tbPanel.insertRow();
    no++;
    row.id = "row" + no;

    // step 1:欄位選擇
    var cell = row.insertCell();
    var fieldInputId = "field" + row.id;
    var newElement = document.createElement("<SELECT ID='" + fieldInputId +
        "' onchange='Javascript:getOpts(" + row.id + ");getInput(" + row.id + ")'></SELECT>");
    cell.insertBefore(newElement);

    // 首次才向伺服器索取欄位清單,之後重用 cache
    if (fieldsInfo == null) {
        fieldsInfo = WebUI.AjaxSearchSystem.AJaxSearchMethod
                       .GetFields(tableName.toString()).value;
    }
    // ...以 "|" 拆分「中文名|欄位名」後填入 options

    // step 2~6:運算子、輸入框、連接條件、刪除鈕、新增鈕
}

值得留意的是那個 if (fieldsInfo == null) 的判斷。欄位定義在整個查詢生命週期內幾乎不變,只在第一次需要時跨網路取回,之後全在記憶體裡解析。這是 Ajax 應用最典型的省法:把「不太變的東西」快取在客戶端。

getOpts 與 getInput:讓介面自己長出正確的樣子

getOpts 收到列物件後,先清空運算子下拉選單的既有選項,再向伺服器呼叫 GetOpts(table, field) 重新填入。伺服器端會依欄位型別分流:字元欄位給「等於、不等於、相似於、不相似於」;數值欄位給「大於、大於或等於、等於、不等於、小於、小於或等於」;日期欄位則給「等於、不等於、先於、後於」。若整數欄位帶有列舉定義,運算子會自動退化成「是/不是」兩項,因為對狀態欄位談大小於毫無意義。

getInput 的邏輯更聰明一些。它先移除同一列第三格已有的輸入元件,接著呼叫 GetEnums 取得型別與可能的列舉值:

  • 沒有列舉值時,動態產生 <input type="text">,並依型別掛上不同的按鍵過濾器——整數用 controlNumberKeyPress,金額用 controlMoneyKeyPress(含千分位與小數位限制),日期則掛上 Calendar 的日期選擇器。
  • 有列舉值時,改為產生 <select>,選項直接由伺服器以 SQL 查出的「顯示文字|實際值」 pairs 填入。

最後再補上一個隱藏欄位,把該列的資料型別記下來,供稍後拼字串時判斷要不要加引號。

DelRow 與 addRow:維持「新增」鈕永遠在最後一列

刪除行為有兩個細節值得學。第一,只剩一列時直接 return,不允許把面板清空。第二,如果刪掉的是最後一列,腳本會先把「新增」鈕補到新的最後一列上,再執行刪除——否則新增鈕會跟著被刪掉,使用者就再也加不出條件了。

function DelRow(row) {
    var rowOfIndex = row.rowIndex;
    if (tbPanel.rows.length == 1) return;
    if (rowOfIndex == tbPanel.rows.length - 1) {
        // 先把新增鈕搬到倒數第二列,再刪除本列
        var cell = tbPanel.rows[rowOfIndex - 1].insertCell();
        var addBtnId = "add" + tbPanel.rows[rowOfIndex - 1].id;
        cell.insertBefore(document.createElement(
            "<INPUT ID='" + addBtnId + "' type='Button' value='新增' " +
            "onclick='Javascript:addRow(" + tbPanel.rows[rowOfIndex - 1].id + ")'>"));
    }
    tbPanel.deleteRow(rowOfIndex);
}

二、getCombinTerm:把整片介面壓縮成一行條件

按下確定鈕時,getCombinTerm 逐列讀取「欄位、運算子、值、型別」,依型別決定值的包裝方式,再用「並且/或者」串接:

  • char:空值時,Like/Not Like 補成 '%%',其餘補成 '';有值時,Like/Not Like 包成 '%值%,其餘包成 '值'。
  • int / decimal:空值一律歸零,避免拼出非法的 SQL。
  • datetime:空值補 '',有值則加上單引號。

拼完的字串寫回隐藏欄位 transValue,後端再從那裡取走。

combinTerm += " " + tableName + "." + field + " " + opt + " " + inputValue;
if (i < lenOfRows - 1) {
    jointMode = tbPanel.rows[i].cells[3].childNodes[0].value;
    combinTerm += " " + jointMode;
}

三、數字輸入的三道防線

查詢面板最容易出包的地方就是數字欄。作者用了三層防護:

  1. controlNumberKeyPress:攔截 keypress,只放過數字鍵。
  2. controlNumberOnKeyUp:keyup 階段比對 oldValue,發現非法字元就把值還原。退格鍵(keyCode 8)、Tab 與 Enter 直接放行。
  3. controlMoneyOnKeyUp:在整數/小數位數上做切斷,並呼叫 addThousandFlag 即時加上千分位逗號,還會補回 currency 符號。

isNumber 特別把數字小鍵盤(keyCode 96~105)也納入判斷,這在很多早期腳本裡是被漏掉的一塊。

四、AJaxSeachPage.aspx:承載面板的宿主頁

頁面結構非常樸素:一個空白的 <table id="tbPanel"> 當容器,上方是確定/取消鈕,頁面底部藏一個 runat="server" 的 hidden 欄位 transValue 用來回傳條件字串。樣式表與兩個腳本(主腳本與 Calendar)在 head 中載入。

五、AJaxSeachPage.ASPX.cs:伺服器端收尾

Code-behind 的職責很輕:註冊 Ajax 型別、掛上確定鈕的用戶端事件,以及把結果塞進 Session。

public const string SEARCH_WHERE_SESSION = "SearchWhere";

private void Page_Load(object sender, System.EventArgs e) {
    if (!IsPostBack) {
        transValue.Value = "employee";   // 實際專案應由 QueryString 帶入白名單表名
        AjaxPro.Utility.RegisterTypeForAjax(typeof(AJaxSearchMethod));
        this.btnOK.Attributes.Add("OnClick", "getCombinTerm()");
    }
}

private void btnOK_Click(object sender, System.EventArgs e) {
    Session[SEARCH_WHERE_SESSION] = transValue.Value.Trim();
    Response.Write(ClosePage());       // 回寫一段 window.close() 關閉自己
}

把 getCombinTerm() 掛在 OnClick 而不是改用 server-side 事件,正是為了讓確定鈕不必觸發一次完整的回傳——條件字串在提交前就已經備好,伺服器只需讀 hidden 欄位即可。

運行效果如下:

原始碼下載:AJaxGeneralSearch.rar

寫在最後:這套設計在今天要怎麼改

這篇文章示範的動態 DOM 組裝手法,在當年是很漂亮的解法,但換到今天有幾個地方值得調整:

  • document.createElement("<SELECT ...>") 這種帶 HTML 字串的寫法只有 IE 吃,標準瀏覽器請改用 createElement 加 appendChild,或直接用模板節點。
  • 把使用者輸入的字串直接拼進 SQL where 子句,本身就是 SQL Injection 的溫床。正式環境請改用參數化查詢,把條件結構化傳到後端再組 SQL。
  • 條件字串放在 hidden 欄位並存入 Session,容易在多分頁情境下互相污染;改用每頁獨立狀態會更穩。

即使如此,「首次取欄位定義並用戶端快取」「依型別動態決定輸入控制項」「新增鈕永遠留在最後一列」這三個想法,放到任何年代的查詢建構器裡都依然成立。

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