DIV CSS 佈局教程網

用 jQuery 實現文本框自動補全效果
編輯:JavaScript綜合知識     

本文以一個封裝成 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
});

使用時只要傳入輸入框物件、資料來源網址與顯示容器即可,元件會自動處理請求、渲染、鍵盤與滑鼠互動,並在點擊頁面其他處時自動收起建議列表。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved