搜尋建議清單若只能用滑鼠點,對重度使用者並不友善。本文示範如何讓上下鍵在建議項目間移動、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,讓螢幕閱讀器也能正確朗讀。