本文以一個封裝成 jQuery 外掛的元件,示範如何實現輸入框的自動補全(autocomplete)效果,支援鍵盤上下鍵選擇、回車確認與滑鼠點選。
整個元件透過 $.Completion 封裝,並提供 $.Completion.DefaultSetting 作為預設設定:
$.Completion.DefaultSetting = {
Completion_Height: null,
Completion_Data_Url: null,
Completion_Obj: null,
Completion_Obj_Show: null,
Completion_Bool: false,
Completion_Count: 10,
Completion_Type_obj: null,
Completion_ClickCall: null
};
元件初始化時(Completion_Loading)會先執行 Init 取得輸入框物件、寬高、資料來源網址等參數,再透過 Completion_Obj_AddEvent 綁定鍵盤事件:
Completion_Obj.keyup(function (event) {
switch (event.keyCode) {
case 38: // 上鍵
case 40: // 下鍵
break;
case 13: // 回車
Completion_ClickCall();
break;
default:
Cimpletion_Bind(); // 按鍵事件延遲操作
}
});
當使用者輸入超過一個字元時,Cimpletion_Bind 會呼叫 Completion_Data_Bind,以 AJAX 向後端請求符合的資料:
function Completion_Data_Bind() {
$.ajax({
url: Completion_Data_Url,
data: { CompletionValue: Completion_Value, CompletionCount: Completion_Count, CompletionType: Completion_Type },
type: "post",
dataType: "json",
success: function (obj) {
Completion_Add_Html(obj); // 構造 HTML
}
});
}
keydown 中處理上下鍵(38、40)的選項切換,並透過 Completion_N 記錄當前選取的索引,搭配 CSS class Completion-guess-list-hover 呈現高亮。滑鼠移入時(MouseHover)也會同步更新索引與輸入框的值,點擊選項則呼叫 Completion_Selected 把文字填入輸入框並隱藏建議列表。
$.Completion({
Completion_Obj: $("#Input_Html"),
Completion_Data_Url: "/CompletionHandler.ashx",
Completion_Height: "auto",
Completion_Obj_Show: $("#show"),
Completion_Bool: true,
Completion_Type_obj: $("#Type"),
Completion_ClickCall: function () { alert(1); },
Completion_Length: 0
});
使用時只要傳入輸入框物件、資料來源網址與顯示容器即可,元件會自動處理請求、渲染、鍵盤與滑鼠互動,並在點擊頁面其他處時自動收起建議列表。