DIV CSS 佈局教程網

jQuery Autocomplete 搭配 ASP.NET 實作要點與踩坑記錄
編輯:關於JavaScript     

用 jQuery Autocomplete 搭配 ASP.NET 的 WebService 或一般處理常式(.ashx)做自動完成,看似簡單,實作時卻常卡在幾個不上不下的細節。以下把實戰中遇到的問題與解法整理出來。

問題一:後端回傳的 JSON 被當成字串

從 WebService 或 .ashx 取回 JSON 字串時,Autocomplete 無法自動識別,會把它當成單一字串處理,導致下拉清單一片空白。解法是自行覆寫 parse 方法,手動 eval 並組出插件需要的資料結構:

$("#txt").autocomplete("/Asmx/ExecutePlan.ashx", {
extraParams:{hosid:HosID,profid:ProfID},
minChars: 0,
max: 700,
mustMatch: true,
autoFill: true,
selectFirst: true,
scrollHeight: 220,
width:640,
scroll:true,
parse: function(data){
var obj=eval("("+data+")");
var row = [];
for(var i = 0; i<obj.length; i++){
row[i] = {data:obj[i], //json
value: obj[i].instName, //列表中中的值
result: obj[i].instName}; //顯示到下拉列表中的
}
if(obj.length == 1)
{
// $("#hfInstID").val(obj[0].executeID);
// $("#Button1").click();
}
return row;
} ,
formatItem: function(row, i, total) {
},
formatMatch: function(row, i, max) {
},
formatResult: function(row, i, max) {
}
});

這裡要注意三個欄位各自的意義:value 是輸入框裡實際填入的文字,result 是顯示於下拉列表中的內容,data 則是完整保留的原始資料,方便後續取用其他欄位(例如把 executeID 塞進隐藏欄位)。

問題二:formatItem 與 formatMatch 失效

覆寫 parse 之後,formatItem 與 formatMatch 這兩個格式化事件就不會被觸發了。這是自訂 parse 時常見的副作用,因為格式化流程已經被你的程式碼接手。

如果只是想在使用者選取值之後做一些處理,可以改用 result 事件。注意這段要另外寫,放在上面那段綁定程式碼之後即可:

$("#txt").result(function(event, data, formatted) {
});

其中 data 是原始資料物件、formatted 是最終顯示的文字,具體參數含義可對照官方開發文件。

補充:記得清掉快取

$("#txt").flushCache();

這個方法用來清空 Autocomplete 的內部快取。實務上很常被忽略:當查詢條件改變(例如使用者切換了上方的院所或科別下拉選單),若不清快取,就會看到上一次查詢殘留的建議清單。合理的做法是在條件變化的 callback 裡呼叫它。

幾點現代化提醒

這套寫法有明顯的時代痕跡,如果今天重做,有幾個地方值得調整:

  • 不要用 eval。改用 JSON.parse(),並讓後端明確設定 Content-Type: application/json;若資料來自不可信來源,eval 等於把執行權交給對方。
  • 改用 jQuery UI Autocomplete。新版 API 以 source 提供資料來源,內建 _renderItem 覆寫點,不必再手寫 parse。
  • minChars 設為 0 要小心。它會在輸入框取得焦點時就送出請求,若資料量大,畫面與伺服器都吃不消;實務上常配合 delay 與最小字元數限制。
  • 保留 mustMatch 的雙向驗證。前端限制只能選清單內的值,但伺服器仍必須驗一次,因為任何客戶端限制都可以被繞過。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved