搜尋框打字時下方跳出候選清單,這個模式從 Google、百度普及之後幾乎成了標配。在表單設計裡,自動完成能解決兩類問題:
一、簡單搜尋。輸入關鍵字,從遠端撈出符合的選項清單,選完把值填回欄位。
二、關聯帶值。使用者輸入產品編號,選定後不只填編號,還要把產品名稱、單價、備註等欄位一併帶進表單的其他位置。這在訂單、報銷這類需要關聯主檔的表單中非常實用,能省下大量重複輸入與查對。
頁面原始碼:https://github.com/xiexingen/Bootstrap-SmartForm/blob/master/demo/form3-ele-autocomplete.html
依賴檔案:jquery-ui.js、jquery.fn.extend.js。
表單渲染完成後,對目標元素呼叫 SmartSearch 方法即可。
data 是要送出的資料物件,若需追加或修改查詢條件,在這裡改它即可。常見用法是補上頁碼、每頁筆數,或帶入表單中其他欄位作為篩選條件。若後端回傳的是單純的字串陣列,formatItem 與 callback 都可以省略,插件會自動把選中的字串填進欄位。
要達到「選一個、填多個」的效果,關鍵在 callback 裡能拿到完整的原始資料,而不只是顯示文字。因此 formatItem 與 callback 通常成對出現:
$('#ProductName').SmartSearch({
url: 'handler/searchProduct.ashx',
beforeSearch: function (data) {
data.keyword = $('#ProductName').val();
data.top = 10;
},
formatItem: function (item) {
// 下拉中顯示:編號 + 名稱
return item.code + ' - ' + item.name;
},
callback: function (item) {
// 選中後把完整資料帶進其他欄位
$('#ProductName').val(item.code);
$('#ProductPrice').val(item.price);
$('#ProductRemark').val(item.remark);
}
});
這裡有個實務上的坑:使用 jQuery UI 的 autocomplete 時,focus 事件預設會把值改成完整顯示文字,導致上下鍵選擇時欄位內容閃動。若只想在確定選檔後才改值,需在 focus 中回傳 false:
focus: function () { return false; }

總體來說,自動完成組件的價值在於「降低輸入成本」與「減少輸入錯誤」——把自由輸入轉為受限選擇,資料品質自然提升。在需要關聯主檔的表單中,這個模式几乎是必備的。