搜尋框的 automatisch 補全是使用者體驗的關鍵細節。一個完整的實作不能只把建議清單顯示出來,還得支援上下鍵切換、Enter 確認、點擊選取,以及點擊空白處關閉。以下逐步拆解。
程式碼開頭先動態插入一個隱藏的下拉容器,並用兩個計數變數管理狀態:maxcount 記錄建議項目的總數,thisCount 記錄當前高亮項的索引。
$(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;
// 上下鍵與 Enter 不觸發查詢
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());
// 點擊某個項目即填入
$("#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) { // Enter
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;
}
}
});
});
為何在上下鍵時先 blur 再 focus。按下方向鍵時讓輸入框失焦,可以讓游標停在選項而非文字中間,避免使用者繼續打字時插入位置錯亂。
邊界判斷。上鍵的 thisCount != 0 與下鍵的 thisCount < maxcount - 1 確保高亮不會超出清單範圍。
為何過濾掉方向鍵與 Enter。keyup 一開始就把 38、40、13 擋掉,避免這三個按鍵也觸發一次後端查詢。
下拉位置。用 offset() 取得輸入框的頁面座標,讓清單在頁面捲動時仍能對齊——這也是為何用 offset 而非 position。
這份實作的資料請求沒有防抖(debounce),使用者快速輸入時會送出大量請求。實務上應該加入約 300 毫秒的延遲,並在每次查詢前取消前一次未完成的請求。另外,高亮效果與樣式直接寫在 JS 裡,較好的做法是用 CSS class 切換;若要正式上線,也可以直接採用 jQuery UI 的 autocomplete,它已處理好鍵盤操作、無障礙屬性與請求節流等細節。