DIV CSS 佈局教程網

為搜尋框加上鍵盤上下鍵切換:以 ECShop 搜尋建議為例
編輯:關於JavaScript     

搜尋建議清單若只能用滑鼠點,對重度使用者並不友善。本文示範如何讓上下鍵在建議項目間移動、Enter 直接採用當前項目,並在停止打字後延遲送出查詢。

鍵盤監聽

/* 鍵盤操作與搜尋建議選擇 */
var curDo = null;
var select = createSelect();

$('#keywords').keyup(function (e) {
  var theEvent = e || window.event;
  var code = theEvent.keyCode ? theEvent.keyCode
           : (theEvent.which ? theEvent.which : theEvent.charCode);

  var KEY = {
    UP: 38, DOWN: 40, DEL: 46, TAB: 9, RETURN: 13,
    ESC: 27, BACKSPACE: 8, LEFT: 37, RIGHT: 39
  };

  // 有新的按鍵輸入,取消尚未執行的延遲查詢
  clearTimeout(curDo);

  switch (code) {
    case KEY.UP:
      select.next();
      break;
    case KEY.DOWN:
      select.prev();
      break;
    case KEY.RETURN:
      $('.suggest-hover').trigger('click');
      break;
    case KEY.LEFT:
    case KEY.RIGHT:
      break;
    default:
      curDo = setTimeout(getSuggest, 300);
      break;
  }
});

選擇邏輯的封裝

/* 建議清單的選擇操作 */
function createSelect() {
  var CLASSES = { ACTIVE: "suggest-hover" };

  function moveSelect(step) {
    var listItems = $('.suggest-results li');
    // 目前高亮項的索引
    var active = $('.' + CLASSES.ACTIVE).index();

    listItems.eq(active).removeClass(CLASSES.ACTIVE);

    active += step;
    if (active < 0) {
      active = listItems.size() - 1;      // 往上越界則跳到最後一項
    } else if (active >= listItems.size()) {
      active = 0;                          // 往下越界則回到第一項
    }

    listItems.eq(active).addClass(CLASSES.ACTIVE);
  }

  return {
    next: function () { moveSelect(-1); },
    prev: function () { moveSelect(1); }
  };
}

幾處值得修正的地方

第一,next 與 prev 的對應反了。在清單中「往下移」應該是索引 +1,而這裡 next 呼叫的是 moveSelect(-1),按下方向鍵下反而會往上跑。把兩者的步進對調即可。

第二,setTimeout(getSuggest(), 300) 這種寫法會立刻執行 getSuggest(),再把它的回傳值當成計時器回呼,因此防抖(debounce)完全失效。正確寫法是傳函數參照:setTimeout(getSuggest, 300)。

第三,listItems.size() 已在 jQuery 3.0 中移除,請改用 listItems.length。

第四,active 為 -1 時(還沒有任何項目被高亮),listItems.eq(-1) 會選到最後一項並移除 class,接著 index 變成 -1 + step,邏輯會走偏。建議在 moveSelect 開頭補上「若 active < 0 則先從 0 或最後一項起始」的處理。

最後,滑鼠移入時別忘了同步更新高亮狀態,否則鍵盤選的位置與視覺提示會不一致;另外搜尋建議屬於動態內容,容器建議加上 role="listbox" 與 aria-activedescendant,讓螢幕閱讀器也能正確朗讀。

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