Suggest Framework 顧名思義,就是一個仿 Google Suggest 的小框架,讓你的輸入框也有下拉提示功能。這種效果能明顯改善搜尋體驗,讓使用者少打字、少拼錯。
把 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」的輸入框都會多出五個屬性:
提交只需要兩個參數: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 範例,但這個框架與平台無關,任何語言都能使用。
.SuggestFramework_List:提示內容所在區域.SuggestFramework_Heading:第一條提示(標題欄).SuggestFramework_Highlighted:目前高亮的那一條.SuggestFramework_Normal:其他提示display.asp)加上 GB2312 轉 UTF-8 的函式,把資料庫讀出的內容轉成 UTF-8。<%@LANGUAGE="VBSCRIPT" CODEPAGE="936"%> 指令。專案頁面:https://sourceforge.net/project/showfiles.php?group_id=145701
最後提醒:延遲值(delay)是這個框架最需要調的參數。設 0 會讓每個按鍵都觸發請求,實務上 200~300 毫秒搭配前端 debounce 是比較平衡的做法;同時建議對回傳的提示文字做 HTML 轉義,避免資料內容被當成標籤執行。