jQuery 的 autocomplete 插件可以讓輸入框在打字時即時顯示候選清單,常見於搜尋框、地址選擇與標籤輸入等情境。使用時,只要呼叫 autocomplete 方法,並傳入資料來源或後端網址即可。
第一個參數可以是 JavaScript 陣列,也可以是會回傳候選資料的網址。第二個參數則是設定物件,用來控制顯示數量、延遲時間、是否自動填入、是否必須完全符合等行為。
minChars 控制至少輸入幾個字元才觸發提示;max 控制下拉清單最多顯示幾筆;delay 控制觸發延遲;autoFill 會把目前選中的值帶入輸入框;mustMatch 可限制只能選擇符合的結果;matchContains 決定是否在字串內部比對;cacheLength 與 matchSubset 則能利用快取減少重複查詢。
formatItem 可以自訂每一筆候選結果的顯示方式,formatResult 則可決定最終寫入輸入框的文字。若需要在使用者選取後執行特定動作,例如跳轉頁面或填入其他欄位,可以使用 result 事件處理。