suggest Framework 框架實現自動提示功能解說和範例

Suggest FrameWork最新版本爲SuggestFramework-0.31

以下爲工程的詳細開發步驟:

 

一.首先來看一下什麼是SuggestFrameWork ework
Suggest Framework 故名思意,就是仿 Google Suggest 的一個小框架,讓你的文本框也有提示功能 。利用suggest framework你可以在自己的網站上很輕鬆實現“輸入提示”效果 ,這種效果 會很大程度上提高用戶 體驗,提高搜索效率。
一個頁面 上可以出現多個搜索框,每個搜索框都可以實現單獨配置。
此框架無瀏覽器 限制,基本兼容當前的絕大多數瀏覽器 ,包括Internet Explorer 5+ (Win/Mac)、Firefox (Win/Mac)、Opera 8+等等。

 

二.下面來介紹一下怎麼安裝
你只需要複製SuggestFramework.js到你的服務器 ,然後自定義提示效果的css樣式,實現個性的搜索提示。
而css樣式文件,需要你自己做好,並且加入到每一個頁面。


三.然後介紹一下如何使用
網頁 的<head></head>標籤中,加入下面兩句:

複製內容到剪貼板
代碼 :
<script type="text/javascript" src="/path/to/SuggestFramework.js"></script>
<script type="text/javascript">window.onload = initializeSuggestFramework;</script>

有了上面兩句後,每個取了名的文本框會多出五個屬性
1.action 必須。接受 GET 方式提交的數據 ,並返回相關 Javascript 數組的動態 頁。
2.capture 如果返回的結果不止一列(比如本例中的單詞和中文 意思),將要替換用戶輸入的那一列(從 1 開始算)。通常這個和數據庫 字段相對應。
可選,默認爲 1.
3.columns 下拉顯示的列數,比如本例中,按字母查詢 單詞,並將中文意思顯示在右側。可選,默認爲 1.
4.delay 查詢延時,單位爲毫秒。較低的延時會得到更快的反應,但會加重服務器負擔。可選,默認爲 1000(1秒)。
5.heading 如果設爲 true ,第一個數組值將作爲不可選擇項(標題欄)。當有兩列或兩列以上數據時非常有用。可選,默認爲 false.

數據提交只需要兩個數據
1.type   輸入框的name
2.q   搜索關鍵字(默認UTF-8編碼)
您下載的壓縮包中,已經包含php和ColdFusion示例,當然這個框架可以適用於所有的編程語言,無平臺 限制。後臺 數據輸出就是一條 Javascript 語句。一維數組這麼寫:
new Array(”val1″, “val2″, “val3″);
二維數組這麼寫:
new Array(
new Array(”第1行條第1列”, “第1行第2列”),
new Array(”第2行條第1列”, “第1行條第2列”),
new Array(”第3行條第1列”, “第1行條第2列”)
);
最後介紹一下,css中需要定義的4個類
.SuggestFramework_List       提示內容所在區域
.SuggestFramework_Heading    第一條提示
.SuggestFramework_Highlighted   設置高亮的一條提示
.SuggestFramework_Normal    其他提示

四.提示,如果出現亂碼 或者javascript腳本錯誤請用下面方法解決。

1. 給後臺返回數據的頁面(例如display.asp) 添加一個 GB2312 轉 UTF-8 的函數,使用此函數把數據庫讀出來的內容轉成 UTF-8 編碼。
2. 如果是後臺爲asp頁面,代碼首行添加 <[email=%@LANGUAGE=”VBSCRIPT]%@LANGUAGE=”VBSCRIPT[/email]” CODEPAGE=”936″%> 指令。
3. 把後臺返回數據的頁面(例如display.asp)文件存成 UTF-8 格式。

e文原文地址http://sourceforge.net/project/shownotes.php?group_id=145701&amp ;release_id=399504
官方下載地址:http://sourceforge.net/project/showfiles.php?group_id=145701



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章