DIV CSS 佈局教程網

jQuery 自帶的自動完成:AJAX 取回候選清單與鍵盤操作
編輯:JQuery特效代碼     

搜尋框打兩個字就跳出候選清單,鍵盤上下鍵挑選、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 開發有所幫助。

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