上一篇把伺服器端的中介資料準備好了——哪些欄位可以查、每個欄位適用哪些運算子、哪些欄位有固定的列舉值。這一篇要動手的是使用者真正看得到的那一半:一個能在瀏覽器裡動態長出條件列、依欄位型別自動切成文字框或下拉選單,最後把整串條件拼裝成查詢片段的查詢面板。
整個腳本圍繞幾個全域變數運作:tbPanel 指向承載條件列的表格控制項,tableName 記住目前查詢的資料表,fieldsInfo 快取第一次向伺服器取回的欄位定義(後續就不再重複請求是關鍵設計),no 則是自我遞增的計數器,用來確保動態產生的 DOM 元素 id 不會互相打結。
新增一列時,腳本依序完成六件事:
| 切開後分別當成顯示文字與值。GetOpts 依當前欄位型別決定。getInput 依型別動態產生。DelRow。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 收到列物件後,先清空運算子下拉選單的既有選項,再向伺服器呼叫 GetOpts(table, field) 重新填入。伺服器端會依欄位型別分流:字元欄位給「等於、不等於、相似於、不相似於」;數值欄位給「大於、大於或等於、等於、不等於、小於、小於或等於」;日期欄位則給「等於、不等於、先於、後於」。若整數欄位帶有列舉定義,運算子會自動退化成「是/不是」兩項,因為對狀態欄位談大小於毫無意義。
getInput 的邏輯更聰明一些。它先移除同一列第三格已有的輸入元件,接著呼叫 GetEnums 取得型別與可能的列舉值:
<input type="text">,並依型別掛上不同的按鍵過濾器——整數用 controlNumberKeyPress,金額用 controlMoneyKeyPress(含千分位與小數位限制),日期則掛上 Calendar 的日期選擇器。<select>,選項直接由伺服器以 SQL 查出的「顯示文字|實際值」 pairs 填入。最後再補上一個隱藏欄位,把該列的資料型別記下來,供稍後拼字串時判斷要不要加引號。
刪除行為有兩個細節值得學。第一,只剩一列時直接 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 逐列讀取「欄位、運算子、值、型別」,依型別決定值的包裝方式,再用「並且/或者」串接:
'%%',其餘補成 '';有值時,Like/Not Like 包成 '%值%,其餘包成 '值'。'',有值則加上單引號。拼完的字串寫回隐藏欄位 transValue,後端再從那裡取走。
combinTerm += " " + tableName + "." + field + " " + opt + " " + inputValue;
if (i < lenOfRows - 1) {
jointMode = tbPanel.rows[i].cells[3].childNodes[0].value;
combinTerm += " " + jointMode;
}
查詢面板最容易出包的地方就是數字欄。作者用了三層防護:
oldValue,發現非法字元就把值還原。退格鍵(keyCode 8)、Tab 與 Enter 直接放行。addThousandFlag 即時加上千分位逗號,還會補回 currency 符號。isNumber 特別把數字小鍵盤(keyCode 96~105)也納入判斷,這在很多早期腳本裡是被漏掉的一塊。
頁面結構非常樸素:一個空白的 <table id="tbPanel"> 當容器,上方是確定/取消鈕,頁面底部藏一個 runat="server" 的 hidden 欄位 transValue 用來回傳條件字串。樣式表與兩個腳本(主腳本與 Calendar)在 head 中載入。
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,或直接用模板節點。即使如此,「首次取欄位定義並用戶端快取」「依型別動態決定輸入控制項」「新增鈕永遠留在最後一列」這三個想法,放到任何年代的查詢建構器裡都依然成立。