DIV CSS 佈局教程網

用 jQuery 打造自動補全輸入框:含鍵盤上下選擇
編輯:JavaScript綜合知識     

搜尋框的 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,它已處理好鍵盤操作、無障礙屬性與請求節流等細節。

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