搜尋框打兩個字就跳出候選清單,鍵盤上下鍵挑選、Enter 確認,這是使用者早已習慣的互動。本文示範一个不依賴外部插件的實作:用 AJAX 向後端取回 JSON 資料,動態組出候選列表,並完整處理滑鼠與鍵盤兩種操作路徑。
$(function() {
// 自動補全
var maxcount = 0;// 表示他最大的值
var thisCount =0;// 初始化他框的位置
$("body").prepend("<div style='width:120px; display:none; background:#FFFFFF; position: absolute;' id='autoTxt'></div>");
$("#sele").keyup(function(even) {
var v = even.which;
if (v == 38 || v == 40 || v == 13)// 當點擊上下鍵或者確定鍵時阻止他傳送數據
{
return;
}
var txt = $("#sele").val();//這裡是取得他的輸入框的值
if (txt != "") {
//拼裝數據
$.ajax({
url : "Birthday_autoCompletion",//從後台取得json數據
type : "post",
dataType : "json",
data : {"bir.userName" : txt
},
success : function(ls) {
var offset = $("#sele").offset();
$("#autoTxt").show();
$("#autoTxt").css("top", (offset.top + 30) + "px");
$("#autoTxt").css("left", offset.left + "px");
var Candidate = "";
maxcount = 0;//再重新得值
$.each(ls, function(k, v) {
Candidate += "<li id='" +maxcount+ "'>" + v + "</li>";
maxcount++;
});
$("#autoTxt").html(Candidate);
$("#autoTxt li:eq(0)").css("background", "#A8A5A5");
//高亮對象
$('body').highLight();
$('body').highLight($("#sele").val());
event.preventDefault();
//當單擊某個LI時反映
$("#autoTxt li").click(function(){
$("#sele").val($("#autoTxt li:eq("+this.id+")").text());
$("#autoTxt").html("");
$("#autoTxt").hide();
});
//移動對象
$("#autoTxt li").hover(function(){
$("#autoTxt li").css("background", "#FFFFFF");
$("#autoTxt li:eq("+this.id+")").css("background", "#A8A5A5");
thisCount=this.id;},function(){
$("#autoTxt li").css("background", "#FFFFFF");});
},
error : function() {
$("#autoTxt").html("");
$("#autoTxt").hide();
maxcount = 0;
}
});
} else {
$("#autoTxt").hide();
maxcount = 0;
$("#sestart").click();
}
});
//當單擊BODY時則隱藏搜索值
$("body").click(function(){
$("#autoTxt").html("");
$("#autoTxt").hide();
thisCount=0;
});
// 寫移動事件//上鍵38 下鍵40 確定鍵 13
$("body").keyup(function(even) {
var v = even.which;
if (v == 38)// 按上鍵時
{
if(thisCount!=0){//等於零時則證明不能上了。所以獲得焦點
$("#sele").blur();
if(thisCount>0)
--thisCount;
else
thisCount=0;
$("#autoTxt li").css("background", "#FFFFFF");
$("#autoTxt li:eq("+thisCount+")").css("background", "#A8A5A5");
}else{$("#sele").focus();}
} else if (v == 40) {// 按下鍵時
if(thisCount<maxcount-1)
{
$("#sele").blur();
++thisCount;
$("#autoTxt li").css("background", "#FFFFFF");
$("#autoTxt li:eq("+thisCount+")").css("background", "#A8A5A5");
}
} else if (v == 13) {// 按確認鍵時
var tt=$("#"+thisCount).text();
if(tt!="")
{
$("#sele").val(tt);
$("#autoTxt").html("");
$("#autoTxt").hide();
}else
{
if($("#sele").val()!="")
$("#sestart").click();
}
} else {
if($("#autoTxt").html()!="")
{
$("#sele").focus();
thisCount=0;
}
}
});
});
頁面載入時先在 body 最前面插入一個隱藏的絕對定位 div 作為候選容器。使用者在 #sele 打字時觸發 keyup,只要不是上下鍵與 Enter(38/40/13),就帶著輸入值以 POST 送出 AJAX 請求。成功回應後,先依輸入框的 offset() 計算容器座標並顯示,再用 $.each 把回傳的陣列組成一串 li,同時把第一項標成選取狀態,最後重新綁定各項的 click 與 hover 行為。
另一段綁在 body 上的 keyup 負責鍵盤操作:38 上移、40 下移、13 確認,並用 thisCount 記錄目前游標位置、maxcount 記錄候選總數,兩者共同約束移動邊界。點擊 body 別處則清空並隱藏候選框。
值得學的是「blur 換 focus」這一招。上下移動時先讓輸入框失焦,是為了避免游標停在文字裡干擾視覺;移動結束再 focus 回來。這個小動作讓鍵盤操作起來更明確。
但這份程式有幾處在實務上會出問題。第一,每次 keyup 都發一次請求,打字快時會產生大量併發請求,回來的先後順序又不保證,可能出現舊結果蓋掉新結果。應加上 debounce(例如等待 250ms 才送出),並在回呼裡比對請求序號或取消前一次請求。
第二,$('body').highLight() 與 $("#sestart").click() 依賴未附上的外掛與元素,直接複製會報錯。第三,success 回呼裡用了全域的 event 物件,這在非 IE 瀏覽器上並不可靠,應從 keyup 的回呼參數 even 傳入並 even.preventDefault()。第四,把使用者輸入直接拼進 HTML 字串有 XSS 風險,若候選資料來源不完全可信,改用 .text() 或先做轉義。
手寫自動完成能完全掌握細節,是很值得做一次的練習,但上線時建議改用 jQuery UI 的 autocomplete 或當前的 Choices.js、Awesomplete 等成熟方案。它們已經處理好了 debounce、鍵盤與 aria-activedescendant 的無障礙對應、ARIA 的 combobox 角色標示、以及與表單驗證的整合。自製版本最容易被忽略的正是無障礙:螢幕閱讀器使用者需要透過 role="listbox"/role="option" 與 aria-expanded 才能理解這個下拉清單的狀態。
以上就是本文的完整說明,希望對你的 jQuery 開發有所幫助。