搜尋框在打字時即時列出建議關鍵字,是現代網站的標準配備。這個效果需要前後端配合:瀏覽器攔截輸入事件,把目前關鍵字送到伺服器換回候選清單,再由前端腳本動態渲染成下拉列表。

一、頁面結構
一個文字輸入框、一顆搜尋按鈕,加上一個初始隱藏的下拉容器。下拉容器在程式執行時才動態建立,插在按鈕後方,等要顯示時再依輸入框位置調整座標。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>搜尋詞自動完成</title>
<style type="text/css">
#search{
text-align: center;
position:relative;
}
.autocomplete{
border: 1px solid #9ACCFB;
background-color: white;
text-align: left;
}
.autocomplete li{
list-style-type: none;
}
.clickable {
cursor: default;
}
.highlight {
background-color: #9ACCFB;
}
</style>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript">
$(function(){
//取得div層
var $search = $('#search');
//取得輸入框JQuery物件
var $searchInput = $search.find('#search-text');
//關閉瀏覽器提供給輸入框的自動完成
$searchInput.attr('autocomplete','off');
//建立自動完成的下拉列表
var $autocomplete = $('<div class="autocomplete"></div>')
.hide()
.insertAfter('#submit');
//清空並隱藏
var clear = function(){
$autocomplete.empty().hide();
};
$searchInput.blur(function(){
setTimeout(clear,500);
});
//目前高亮項目的索引
var selectedItem = null;
var timeoutid = null;
//設定高亮背景
var setSelectedItem = function(item){
selectedItem = item ;
if(selectedItem < 0){
selectedItem = $autocomplete.find('li').length - 1;
}
else if(selectedItem > $autocomplete.find('li').length-1 ) {
selectedItem = 0;
}
$autocomplete.find('li').removeClass('highlight')
.eq(selectedItem).addClass('highlight');
};
var ajax_request = function(){
$.ajax({
'url':'/test/index.jsp',
'data':{'search-text':$searchInput.val()},
'dataType':'json',
'type':'POST',
'success':function(data){
if(data.length) {
$.each(data, function(index,term) {
$('<li></li>').text(term).appendTo($autocomplete)
.addClass('clickable')
.hover(function(){
$(this).siblings().removeClass('highlight');
$(this).addClass('highlight');
selectedItem = index;
},function(){
$(this).removeClass('highlight');
selectedItem = -1;
})
.click(function(){
$searchInput.val(term);
$autocomplete.empty().hide();
});
});
var ypos = $searchInput.position().top;
var xpos = $searchInput.position().left;
$autocomplete.css('width',$searchInput.css('width'));
$autocomplete.css({'position':'relative','left':xpos + "px",'top':ypos +"px"});
setSelectedItem(0);
$autocomplete.show();
}
}
});
};
$searchInput
.keyup(function(event) {
if(event.keyCode > 40 || event.keyCode == 8 || event.keyCode ==32) {
$autocomplete.empty().hide();
clearTimeout(timeoutid);
timeoutid = setTimeout(ajax_request,100);
}
else if(event.keyCode == 38){
if(selectedItem == -1){
setSelectedItem($autocomplete.find('li').length-1);
}
else {
setSelectedItem(selectedItem - 1);
}
event.preventDefault();
}
else if(event.keyCode == 40) {
if(selectedItem == -1){
setSelectedItem(0);
}
else {
setSelectedItem(selectedItem + 1);
}
event.preventDefault();
}
})
.keypress(function(event){
if(event.keyCode == 13) {
if($autocomplete.find('li').length == 0 || selectedItem == -1) {
return;
}
$searchInput.val($autocomplete.find('li').eq(selectedItem).text());
$autocomplete.empty().hide();
event.preventDefault();
}
})
.keydown(function(event){
if(event.keyCode == 27 ) {
$autocomplete.empty().hide();
event.preventDefault();
}
});
$(window).resize(function() {
var ypos = $searchInput.position().top;
var xpos = $searchInput.position().left;
$autocomplete.css('width',$searchInput.css('width'));
$autocomplete.css({'position':'relative','left':xpos + "px",'top':ypos +"px"});
});
});
</script>
</head>
<body>
<div id = "search">
<label for="search-text">請輸入關鍵詞</label><input type="text" id="search-text" name="search-text" />
<input type="button" id="submit" value="搜尋"/>
</div>
</body>
</html>
二、伺服器端
這裡用 JSP 示範,換成 PHP、Node.js 或其他語言都可以,重點只是「依關鍵字回傳一段 JSON 陣列」。
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%
String []words = {"amani","abc","apple","abstract","an","bike","byebye",
"beat","be","bing","come","cup","class","calendar","china"};
if(request.getParameter("search-text") != null) {
String key = request.getParameter("search-text");
if(key.length() != 0){
String json="[";
for(int i = 0; i < words.length; i++) {
if(words[i].startsWith(key)){
json += "\""+ words[i] + "\"" + ",";
}
}
json = json.substring(0,json.length()-1>0?json.length()-1:1);
json += "]";
out.println(json);
}
}
%>
三、整體思路回顧
流程其實相當直觀:在輸入框上註冊 keyup,判斷按下的不是方向鍵、Enter、Esc 這類控制鍵才發請求;用 setTimeout 加上 clearTimeout 做簡短的 debounce,避免每敲一個字就打一次伺服器;取回 JSON 後,每筆資料建一個 li,並在該 li 上掛 click 與 hover。
鍵盤操作的關鍵是「記住目前高亮的索引」。selectedItem 就是這個索引,上下鍵讓它加減一並循環(小於 0 跳到最後一筆、超出範圍回到 0),Enter 把該筆文字填回輸入框,Esc 直接關閉。-1 被拿來當作「滑鼠已離開、目前無高亮」的哨兵值。
下拉層的位置依輸入框的 position() 計算,並額外綁定 resize,視窗尺寸改變時重新對齊。另外 blur 裡刻意延遲 500 毫秒才清空,是為了讓使用者有時間點擊下拉項目——這是自製自動完成最經典的坑之一。
四、如果今天重寫,我會這樣調整
這個範例寫於 jQuery 1.4 的年代,放到現在有幾處值得改良。第一,鍵盤判斷改用 e.key 或 e.which,並明確排除所有控制鍵,而不是用 keyCode > 40 這種粗放條件。第二,為下拉容器加上 role="listbox"、每個項目加 role="option" 與 aria-selected,並用 aria-activedescendant 把目前高亮項告知螢幕閱讀器,這才是 WAI-ARIA autocomplete 標準做法。第三,請求應可取消(AbortController),避免慢網路下舊回應覆蓋新回應。第四,伺服器回傳前務必做 HTML 轉義,防止 XSS;前端用 .text() 而非 .html() 帶入文字也是同樣用意。
jQuery 是 web 前端的利器,讀懂這類經典範例,再對照現代做法,會是很有收穫的練習。