在當前的 Web 設計思維裡,使用者體驗是企業最在意的一環。而搜尋框裡「打兩個字就跳出候選關鍵字」這種自動補全功能,正是最直接、也最容易被感知的互動設計——今天大概已經很難找到不做這件事的網站了。Google 的搜尋框就是最經典的示範:

這裡要介紹的是 jQuery AutoComplete 外掛。它的擴充性相當好、執行效能也不錯,整合進既有專案很省事;瀏覽器相容性涵蓋 IE 6 以上、Firefox、Safari、Opera 與 Chrome 等主流版本。
線上展示:https://www.devbridge.com/projects/autocomplete/jquery/#demo
第一步很單純,把 jQuery 本體與外掛都載入:
<script src="jquery.js" type="text/javascript"></script> <script src="jquery.autocomplete.js" type="text/javascript"></script>
先在頁面上準備一個輸入框:
<input id="query" name="q" />
接著初始化。這裡務必確認 DOM 已經就緒再執行,否則在 IE 底下容易出錯——最穩妥的做法是包在 $(document).ready() 裡:
$("#query").autocomplete({
serviceUrl: "service/autocomplete.ashx", // 處理請求的後端路徑
minChars: 2, // 打幾個字才觸發查詢
maxHeight: 400, // 建議清單最大高度(px)
width: 300, // 清單寬度
zIndex: 9999,
deferRequestBy: 300, // 輸入中的延遲,避免每打一字就發一次請求
params: { country: "Yes" }, // 額外帶的參數
onSelect: function (data, value) { }, // 選中項目時的回呼
lookup: ["January", "February", "March"] // 本機資料來源
});
deferRequestBy 這個參數很值得調整。設成 0 的話,使用者每敲一個字就會打一次後端;設成 300 毫秒左右,能大幅降低不必要的請求量,對伺服器友善很多。
資料來源有兩種寫法。走後端時,回應格式長這樣:
{
query: "Li", // 使用者原始的輸入
suggestions: ["Liberia", "Libyan Arab Jamahiriya", "Liechtenstein", "Lithuania"],
data: ["LR", "LY", "LI", "LT"] // 選項對應的鍵值,會傳進回呼函式
}
如果資料量不大,直接用本機陣列反而更快:
lookup: ["January", "February", "March"]
外掛也支援隨時開關與改設定:
var ac = $("#query").autocomplete({ /* 參數 */ });
ac.disable();
ac.enable();
ac.setOptions({ zIndex: 1001 });
最後一層是外觀。外掛產生的結構是 div 包 div,每個候選項目各自一個 div,命中的關鍵字會被包進 <strong>:
<div class="autocomplete-w1">
<div class="autocomplete" style="width: 299px;">
<div><strong>Li</strong>beria</div>
<div><strong>Li</strong>byan Arab Jamahiriya</div>
<div class="selected"><strong>Li</strong>thuania</div>
</div>
</div>
.autocomplete-w1 {
background: url(img/shadow.png) no-repeat bottom right;
position: absolute;
top: 0; left: 0;
margin: 6px 0 0 6px;
}
.autocomplete {
border: 1px solid #999;
background: #FFF;
cursor: default;
text-align: left;
max-height: 350px;
overflow: auto;
margin: -6px 6px 6px -6px;
}
.autocomplete .selected { background: #F0F0F0; }
.autocomplete div { padding: 2px 5px; white-space: nowrap; overflow: hidden; }
.autocomplete strong { font-weight: normal; color: #3399FF; }
把 .selected 的底色與 strong 的字色改一改,就能貼合自家網站的視覺調性。
外掛介紹與下載:www.devbridge.com/projects/autocomplete/jquery/
另外,如果你所屬的專案是走 MooTools 這條路線,也有對應的自動補全方案可參考:www.ajaxdaddy.com/mootools-autocomplete.html
自動補全很容易不小心變成效能炸藥。三個建議:後端加上快取,把高頻查詢詞先記起來;限制 minChars 不要設成 1,單字查詢會撈出太多結果;用 deferRequestBy 拉開請求間隔。這三點做好,這個功能就會是加分項而不是負擔。