需求是這樣的:希望 autocomplete 的下拉聯想選單能用鍵盤上下鍵移動,而且輸入框裡的值要同步跟著變,就像 Google、百度搜尋框那樣。網上找了很久沒找到現成能完全符合的插件,最後只能自己改原始碼。
在原始碼中找到 KEY.DOWN 與 KEY.UP 的處理分支,原本的 DOWN 分支長這樣:
case KEY.DOWN:
event.preventDefault();
if ( select.visible() ) {
select.next();
}
else {
onChange(0, true);
}
break;
在 select.next() 之後補上把選中值寫回輸入框的邏輯:
var selected = select.selected(); var v = selected.result; $input.val(v);
改完後上下鍵時輸入框裡確實會出現對應的值,但下拉選單裡的高亮游標卻消失了——因為我們只是把值塞進輸入框,選單本身的選中狀態並沒有跟上。
先找到 select.next() 的定義:
next: function() {
moveSelect(1);
},
仿照它加一個新方法:
stay: function() {
moveSelect(1);
},
case KEY.DOWN:
event.preventDefault();
if ( select.visible() ) {
select.next();
var selected = select.selected();
var v = selected.result;
$input.val(v);
select.stay(); // 讓選單高亮同步
}
else {
onChange(0, true);
}
break;
這樣上下鍵時,輸入框的值與選單的高亮就會一起移動了。
非常感謝原作者的基礎程式。加上 stay() 之後發現一個問題:按一次上下鍵,高亮會隔一行跳。原因很明顯——next() 已經把選項移了一格,stay() 又呼叫 moveSelect(1) 再移一格,等於一次動兩格。
解法是把 stay() 的位移量改成 0:
stay: function() {
moveSelect(0);
},
如此一來 next() 負責實際移動,stay() 只負責讓游標「停在當前位置」而不重複位移,兩者分工清楚。
這個案例有個通用價值:當你為了修正一個問題而加入新邏輯時,要確認它和既有邏輯沒有功能重疊。原本的 next() 已經承擔了移動,我卻又寫了一個做同樣事的 stay(),於是效果加倍。把新方法的職責收窄到「不重複移動」,問題就消失了。
另外提醒,直接修改第三方插件原始碼會帶來維護負擔——插件一升級,你的改動就被覆蓋。若插件有提供 option 或事件回呼,優先用擴充點;真的非改不可,建議把改動集中記錄成 patch 檔案,並在註解裡標明修改位置與原因,日後升級時才好對照。本例中的 autocomplete 插件已停止維護,新專案建議改用 jQuery UI 的 autocomplete 或 select2,它們原生就支援鍵盤操作與 select 事件。