DIV CSS 佈局教程網

用 jQuery 打造 Google 風格搜尋框自動完成提示(改良版)
編輯:JQuery特效代碼     

成品長什麼樣子

本文示範的 autopoint 外掛,能讓一個再普通不過的 text 輸入框變成「邊打字、邊出建議」的智慧搜尋框:查詢字串丟到後端,回傳的候選字以清單形式浮在輸入框下方,還可以用上下方向鍵挑選、Enter 確認,或用滑鼠直接點。整體封裝成一行 jQuery 呼叫,換頁面上任何一個輸入框都能用。

外掛主體:autopoint.js

程式包在 (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>

後端:Servlet 輸出 JSON

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:...}]} 這樣的結構就能跑。

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