DIV CSS 佈局教程網

Bootstrap 智能表單實戰:自動完成(Autocomplete)組件
編輯:關於JavaScript     

搜尋框打字時下方跳出候選清單,這個模式從 Google、百度普及之後幾乎成了標配。在表單設計裡,自動完成能解決兩類問題:

一、簡單搜尋。輸入關鍵字,從遠端撈出符合的選項清單,選完把值填回欄位。

二、關聯帶值。使用者輸入產品編號,選定後不只填編號,還要把產品名稱、單價、備註等欄位一併帶進表單的其他位置。這在訂單、報銷這類需要關聯主檔的表單中非常實用,能省下大量重複輸入與查對。

使用方式

頁面原始碼:https://github.com/xiexingen/Bootstrap-SmartForm/blob/master/demo/form3-ele-autocomplete.html

依賴檔案:jquery-ui.js、jquery.fn.extend.js。

表單渲染完成後,對目標元素呼叫 SmartSearch 方法即可。

參數說明

  • url:請求的後端位址,必須回傳鍵字搜尋所需的資料。
  • beforeSearch(可選):送出請求前呼叫。參數 data 是要送出的資料物件,若需追加或修改查詢條件,在這裡改它即可。常見用法是補上頁碼、每頁筆數,或帶入表單中其他欄位作為篩選條件。
  • formatItem(可選):自訂下拉項目顯示的樣貌。若後端回傳的不是單純字串陣列,就必須實作這個函數。範例中顯示的是「產品編號 + 產品名稱」的組合,讓使用者更容易辨識。
  • callback(可選):自訂選中後的賦值行為。同樣地,只有在回傳結構不是簡單字串陣列時才需要。

若後端回傳的是單純的字串陣列,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; }

後端要注意的事

  • 關鍵字務必參數化查詢,切勿拼接 SQL,否則等於開了 injection 的大門。
  • 一定要限制回傳筆數(例如 10 筆)。少了上限,使用者打一個字就可能拉回數萬筆資料。
  • 回傳的 JSON 只給前端需要顯示與帶值的欄位,不要把整筆含敏感資訊的資料都丟出來。
  • 加入最基本的請求頻率限制,避免被打成免費查詢接口。

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

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved