DIV CSS 佈局教程網

仿 Google 搜尋提示:SuggestFramework 使用說明
編輯:AJAX基礎知識     

Suggest Framework 顧名思義,就是一個仿 Google Suggest 的小框架,讓你的輸入框也有下拉提示功能。這種效果能明顯改善搜尋體驗,讓使用者少打字、少拼錯。

特性

  • 同一個頁面可以有多個搜尋框,每個都能獨立設定。
  • 無瀏覽器限制,基本相容絕大多數瀏覽器,包含 Internet Explorer 5+(Win/Mac)、Firefox(Win/Mac)、Opera 8+ 等。

安裝

把 SuggestFramework.js 複製到你的伺服器即可,而 CSS 樣式檔需要自己撰寫以做出個人化的提示外觀,並加入每一個頁面。該 JS 檔已用 Dojo ShrinkSafe 壓縮過(https://alex.dojotoolkit.org/shrinksafe/)。

使用方式

在網頁的 <head> 中加入兩行:

<script type="text/javascript" src="/path/to/SuggestFramework.js"></script>
<script type="text/javascript">window.onload = initializeSuggestFramework;</script>

五個可設定的屬性

有了這兩行之後,每個「取了 name」的輸入框都會多出五個屬性:

  1. action(必填):接受 GET 方式提交並回傳相關 JavaScript 陣列的動態頁。
  2. capture:如果回傳結果不止一列(例如單字與中文意思),指定要替換使用者輸入的那一列(從 1 開始算)。通常對應資料庫欄位。預設 1。
  3. columns:下拉顯示的列數。例如按字母查單字並在右側顯示中文意思。預設 1。
  4. delay:查詢延遲,單位毫秒。延遲越低反應越快,但伺服器負擔越重。預設 1000(1 秒)。
  5. heading:設為 true 時,第一個陣列值會作為不可選擇的標題欄。有兩列以上資料時很有用。預設 false。

資料格式

提交只需要兩個參數:type(輸入框的 name)與 q(搜尋關鍵字,預設 UTF-8 編碼)。後端輸出的就是一行 JavaScript 敘述。

一維陣列:

new Array("val1", "val2", "val3");

二維陣列:

new Array(
  new Array("第1列第1欄", "第1列第2欄"),
  new Array("第2列第1欄", "第2列第2欄"),
  new Array("第3列第1欄", "第3列第2欄")
);

壓縮包中已包含 PHP 與 ColdFusion 範例,但這個框架與平台無關,任何語言都能使用。

CSS 需要定義的四個類別

  • .SuggestFramework_List:提示內容所在區域
  • .SuggestFramework_Heading:第一條提示(標題欄)
  • .SuggestFramework_Highlighted:目前高亮的那一條
  • .SuggestFramework_Normal:其他提示

遇到亂碼或腳本錯誤怎麼辦

  1. 在後端回傳資料的頁面(例如 display.asp)加上 GB2312 轉 UTF-8 的函式,把資料庫讀出的內容轉成 UTF-8。
  2. 若後端是 ASP 頁面,在程式碼首行加上 <%@LANGUAGE="VBSCRIPT" CODEPAGE="936"%> 指令。
  3. 把後端回傳資料的頁面存成 UTF-8 格式。

專案頁面:https://sourceforge.net/project/showfiles.php?group_id=145701

最後提醒:延遲值(delay)是這個框架最需要調的參數。設 0 會讓每個按鍵都觸發請求,實務上 200~300 毫秒搭配前端 debounce 是比較平衡的做法;同時建議對回傳的提示文字做 HTML 轉義,避免資料內容被當成標籤執行。

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