DIV CSS 佈局教程網

打造 jQuery 好友選擇器 V2.0 插件:從前端到後端的完整實踐
編輯:JQuery特效代碼     

查看 DEMO 點擊下載

好友選擇器說到底是一個牽扯頗多的組件,既要處理繁瑣的前端交互,又要與後端數據緊密協作。本文重點講解前端的實現思路,而後端數據則由我寫的幾個簡單 ASP 頁面來提供支撐。

一、代碼風格:以類的形式組織

我把整個組件包裝成一個 jQuery 插件,並將它當作一個類來看待。這樣做的好處很直觀——同一個頁面上可以並存多個好友選擇器,彼此互不干擾。

所有可配置的參數都在最底部的 giant.ui.friendsuggest.defaults 中給出了默認值,未傳入時便自動採用這些默認配置。此外,凡是以下劃線開頭的方法,我都約定為私有方法,理論上不允許外部調用。

二、DOM 結構:預先寫進 XHTML

我的 DOM 結構並非由 JS 動態生成,而是提前寫在 XHTML 頁面裡。這麼做主要是考慮到:萬一 JS 不可用,至少還能保住基本的搜索功能。這也正是「漸進增強」理念的體現。

<div id="ui-fs" class="ui-fs">
<div class="ui-fs-result clearfix">
</div>
<div class="ui-fs-input">
<input type="text" value="輸入好友姓名(支持全拼輸入)" maxlength="30" />
<a class="ui-fs-icon" href="javascript:void(0)" title="查看所有好友">查看所有好友</a>
</div>
<div class="ui-fs-list">
數據加載中....
</div>
<div class="ui-fs-all">
<div class="top">
<select id="ui-fs-friendtype"><option value="-1">所有好友</option></select>
<div class="close" title="關閉">關閉</div>
</div>
<div class="ui-fs-allinner">
<div class="page clearfix">
<div class="llight1">還有<b>30</b>人可選</div><div class="button"><span class="prev">上一頁</span><span class="next">下一頁</span></div>
</div>
<div class="list clearfix">
數據加載中...
</div>
</div>
</div>
</div>

三、數據格式:三類接口各司其職

組件一共請求三種數據。第一類是好友類別數據,在組件初始化時獲取,採用 JSON 格式:

[{name:'以前的同事',id:'1'},{name:'現在的同事',id:'2'}]

第二類是各好友類別下的好友總數,用來在彈出全部好友時做分頁計算。數據格式是一個 Int,直接輸出數字即可。獲取時傳入的參數為 typeId(好友類別 ID),當值為 -1 時表示統計所有好友的總數。

第三類是好友列表數據,同樣是 JSON 格式:

[{fUid:1,friendUserName:'karry',friendHeadPic:'images/1.jpg'},{fUid:2,friendUserName:'kaliy',friendHeadPic:'images/2.jpg'}]

列表數據的獲取分兩種場景。一種是輸入框裡輸入字符時觸發,用 name 參數存放輸入內容;另一種是點擊右側按鈕展示全部好友時觸發,由於涉及分頁與下拉框過濾,參數較多,共三個:typeId(當前類別)、p(當前頁碼)、pageSize(每頁顯示人數)。

四、功能簡介

組件同時支持多選與單選兩種模式,初始化時通過參數控制,默認為多選。單選模式下還可以傳入一個回調函數,在用戶選中某位好友時觸發。

整個組件最核心的部分,莫過於事件監聽與數據的異步獲取。組件涉及 focus、blur、click、keyup、change 五個事件,我將它們拆分到不同的私有方法中分別綁定:_clickBind(); _focusBind(); _blurBind(); _keyUpBind(); _selectChangeBind();

其中對 input 的鍵盤事件監聽最為複雜,需要兼顧多種情況。通常每敲一個鍵都要向後台請求一次數據,但還要對上下左右方向鍵與回車鍵做特殊處理,具體可參考源碼。

另一處關鍵處理是:重複選擇的好友會以閃動變色來提示,這裡主要依靠 setInterval() 實現。

var i = 0;
var $obj = $($this.opts.resultContainer).find("[name='" + fUid + "']");
$obj.css("background-color", "#fff");
//變色
var interval = setInterval(function() {
//IE和FF顏色輸出不一樣
if ($obj.css("background-color") == "#ffffff" || $obj.css("background-color") == "rgb(255, 255, 255)") {
$obj.css("background-color", "#6699cc");
$obj.css("color", "#fff");
} else {
$obj.css("background-color", "#ffffff");
$obj.css("color", "#666666");
}
i++;
if (i == 4) {
$obj.attr("style", "");
clearInterval(interval);
}
}, 300);

多選模式下,已選中的好友可通過 getResult() 方法獲取,它會返回一個存放好友 id 的數組。

五、默認參數

前面大部分參數主要用於指定 DOM 中對應的按鈕與容器,只要不改動 DOM 結構,這些參數通常無需調整。

/**
* 默認參數
* <pre>
* totalSelectNum 多選模式下,最多選取人數,默認為30
* selectType 選擇模式,默認為多選"multiple",若為單選,則用single
* selectCallBack 單選模式下,選中之後的回調函數。
* </pre>
* */
giant.ui.friendsuggest.defaults = {
btnAll:"#ui-fs .ui-fs-icon",
btnCloseAllFriend:"#ui-fs .ui-fs-all .close",
btnNextPage:"#ui-fs .ui-fs-all .next",
btnPrevPage:"#ui-fs .ui-fs-all .prev",
selectFriendType:"#ui-fs-friendtype",
allFriendContainer:"#ui-fs .ui-fs-all" ,
allFriendListContainer:"#ui-fs .ui-fs-all .ui-fs-allinner div.list",
frinedNumberContainer:"#ui-fs .ui-fs-allinner .page b",
resultContainer:"#ui-fs .ui-fs-result",
input:"#ui-fs .ui-fs-input input",
inputContainer:"#ui-fs .ui-fs-input",
dropDownListContainer:"#ui-fs .ui-fs-list",
inputDefaultTip:"輸入好友姓名(支持全拼輸入)",
noDataTip:"您的好友列表中不存在該好友",
ajaxUrl:"ajax.asp",
ajaxLoadAllUrl:"ajax.asp",
ajaxGetCountUrl:"ajaxcount.asp",
ajaxGetFriendTypeUrl:"ajaxFriendType.asp",
totalSelectNum:30,
ajaxBefore:null,
ajaxError:null,
selectType:"multiple",
selectCallBack:null
};

六、調用方式

在 DOM 結構保持不變的前提下,調用非常簡單:

var test = new giant.ui.friendsuggest();

記得把它放在 $(document).ready(function(){}) 裡面,否則會找不到對應的 DOM。若需要修改參數,對照上面的默認配置,想改哪個就傳哪個進去即可。

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