自動完成元件能在使用者輸入時即時提示可能的選項,是搜尋框的常見配置。本文示範如何以 jQuery UI 實作並說明其方法與事件。
在頁面初始化時,將輸入框包裝成 jQuery 物件,再呼叫 autocomplete(),同時設定最小觸發字數與資料來源:
$(document).ready(function () {
var keys = ["jsp", "javascript", "jquery", "asp", "asp.net", "php"];
$('#searchBox').autocomplete({
source: keys,
minLength: 2
});
});

自動完成元件提供 search、open、focus、select、close、change 等事件,其回呼函數中的 ui.item 為一個含 label 與 value 屬性的物件:
function (event, ui) {
// event: 觸發事件時的事件物件
// ui.item: 包含 label 與 value 的物件
}
以下範例示範動態過濾資料來源:使用者在 search 事件中,依目前輸入的關鍵字即時計算符合的選項並更新 source:
var keys = ["c++", "c#", "c", "java", "j2ee", "jsp", "javascript", "jquery",
"asp", "asp.net", "ruby", "vb.net", "visual basic", "vb",
"photoshop", "php", "flax", "flash"];
function GetValues(key) {
var ks = [];
if (key == "") return ks; // 關鍵字為空則回傳空集合
for (var i = 0; i < keys.length; i++) {
if (keys[i].indexOf(key) == 0) { ks[ks.length] = keys[i]; }
}
return ks;
}
$('#searchBox').autocomplete({
source: [],
search: function (event, ui) {
$('#searchBox').autocomplete("option", "source", GetValues($(this).val()));
}
});

透過 source 與 search 事件的搭配,就能輕鬆打造具備即時過濾能力的搜尋建議框。