本文示範的 autopoint 外掛,能讓一個再普通不過的 text 輸入框變成「邊打字、邊出建議」的智慧搜尋框:查詢字串丟到後端,回傳的候選字以清單形式浮在輸入框下方,還可以用上下方向鍵挑選、Enter 確認,或用滑鼠直接點。整體封裝成一行 jQuery 呼叫,換頁面上任何一個輸入框都能用。
程式包在 (function($){ ... })(jQuery) 的閉包裡,不污染全域;可調參數集中在 defaults,再用 $.extend 與使用者傳入的設定合併。
defaults = {
url: options.url,
keyLeft : 37, // 向左方向鍵
keyUp : 38, // 向上方向鍵
keyRight : 39, // 向右方向鍵
keyDown : 40, // 向下方向鍵
keyEnter : 13, // 回車鍵
listHoverCSS : 'jhover', // 清單滑鼠懸浮樣式
tpl : '<div class="list"><div class="word">{word}</div><div class="view">約{view}條記錄</div></div>',
topoffset: options.topoffset || 5
};
var options = $.extend(defaults, options);
接著在 body 上建立一個共用的提示層 dropDiv,並用 isOver 旗標記錄滑鼠是否停在提示層上——這個旗標稍後處理 blur 時會用到,避免滑鼠移到清單上時提示層被提早關掉。
keydown 事件只在提示層顯示時才攔截。按下向下鍵時,若目前沒有任何一列被選中,就高亮第一列並把它的文字填回輸入框;若已在最後一列,則取消所有高亮(等於把焦點交還輸入框);其餘情況就往下移一格。向上鍵邏輯完全對稱,只是改成從最後一列開始往回走。Enter 鍵則清空並隱藏提示層。
為了避免「值沒變卻一直發請求」,程式在按下按鍵前先把輸入框內容塞進 alt 屬性當暫存;keyup 時比對兩者,若值一樣或已清空就直接返回,上下鍵的 keyup 也直接略過。
$(this).attr('alt', $(this).val());
}).bind('keyup', function(event){
if (event.keyCode == options.keyDown || event.keyCode == options.keyUp) return;
if ($(this).val() == '') { dropDiv.empty().hide(); return; }
if ($(this).val() == $(this).attr('alt')) return;
getData(pa, $(this).val());
}).bind('blur', function(){
if (isOver && dropDiv.find('.' + options.listHoverCSS) != 0) return;
dropDiv.empty().hide();
});
handleResponse 先檢查回傳的 JSON 有沒有 data 欄位,沒有就提示格式錯誤;有但為空則安靜返回。真正組 DOM 的是 render:它拿 options.tpl 當模板,用正則 /\{([a-z]+)\}/ig 把 {word}、{view} 換成實際欄位值,再交給 jebind 插入並重新綁定 mouseover 與 click。
refreshDropDiv 負責把提示層對齊到輸入框正下方:left 取輸入框的 offset().left,top 是 offset().top 加上高度與 topoffset,寬度預設跟輸入框等寬。定位完再呼叫一次 parent.focus(),這是為了處理「Ajax 還沒回來輸入框就先失焦」導致提示框不消失的狀況。
最後 getData 用 GET 發 word=關鍵字,dataType 設為 json,timeout 一秒。
<style type="text/css">
.dropDiv { position: absolute; z-index: 10; display: none; cursor: hand; }
.dropDiv .jhover { background-color: #00FEDF; }
.dropDiv .list { float: left; width: 100%; }
.dropDiv .word { float: left; }
.dropDiv .view { float: right; color: gray; text-align: right; font-size: 10pt; }
</style>
<script type="text/javascript" src="../js/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="../js/autopoint-1.0.1.js"></script>
<script type="text/javascript">
$(function(){
$("input").autopoint({url:'https://localhost/xun/ajax.svl?method=getsearchhelp'});
});
</script>
<body>
<input type="text" size="50" />
<input type="text" size="50" />
</body>
response.setContentType("text/html");
response.setHeader("Cache-Control", "no-cache");
response.setCharacterEncoding("UTF-8");
String word = request.getParameter("word");
if (Utils.isBlank(word)) return;
JSONObject json = new JSONObject();
JSONArray array = new JSONArray();
Map<String, Object> map1 = new HashMap<String, Object>();
map1.put("word", word + "a1");
map1.put("view", 10);
// map2、map3 依此類推,word 分別為 a2 / a3,view 為 15 / 2
array.add(JSONObject.fromObject(map1));
json.put("data", array);
PrintWriter out = response.getWriter();
out.print(json.toString());
out.close();
這裡的 JSONObject、JSONArray 來自 json-lib.jar。為了方便測試,範例是直接拼假資料回傳,實務上把這段換成查資料庫即可,前端契約不變:只要回傳 {data:[{word:..., view:...}]} 這樣的結構就能跑。