|
|
1.代碼風格
我的組件是作為一個Jquery 的插件來做的。把整個組件做為一個類來處理。這樣也方便在一個頁面上多個好友選擇器共存而不相互影響。
所有需要寫的參數(shù)都在最下面的giant.ui.friendsuggest.defaults 中給了默認值。在未傳入?yún)?shù)時，會調(diào)用默認值。另外，在以下劃線開頭的方法，我約定為私有方法，理論上不允許外部調(diào)用它們。
2.Dom結(jié)構(gòu)
我的DOM結(jié)構(gòu)沒有在JS里面構(gòu)造出來，而是預先下載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">
數(shù)據(jù)加載中....
</div>
<div class="ui-fs-all">
<div class="top">
<select id="ui-fs-friendtype"><option value="-1">所有好友</option></select>
<div class="close" title="關(guān)閉">關(guān)閉</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">
數(shù)據(jù)加載中...
</div>
</div>
</div>
</div>
3.數(shù)據(jù)格式
請求了3種不同的數(shù)據(jù)，首先是好友類別數(shù)據(jù)，在剛初始化組件的時候去獲取，JSON 格式，格式為
[{name:'以前的同事',id:'1'},{name:'現(xiàn)在的同事',id:'2'}]
然后是對應好友類別的好友總數(shù)，用來在點擊彈出所有好友時做分頁使用。數(shù)據(jù)格式為Int型，直接輸出一個數(shù)字就行了。獲取數(shù)據(jù)時使用的參數(shù)為typeId,即好友類別的ID，為-1時獲取所有好友的總數(shù)。
最后是好友列表數(shù)據(jù)，也是JSON格式。格式為：
[{fUid:1,friendUserName:'karry',friendHeadPic:'images/1.jpg'},{fUid:2,friendUserName:'kaliy',friendHeadPic:'images/2.jpg'}]
數(shù)據(jù)的獲取分兩種情況。
一種是輸入框中輸入字符時獲取的數(shù)據(jù)，用name參數(shù)來存放輸入框中輸入的內(nèi)容。
第二種是點擊右側(cè)按鈕出現(xiàn)的所有好友的情況，由于涉及到分頁、下拉列表框的過濾等，所以參數(shù)比較多，有三個參數(shù)：typeId、p、pageSize typeId代表當前的類別，p代表當前的頁碼，pageSize 代表每頁顯示的人數(shù)。
4 功能簡介
組件支持多選和單選兩種模式，在初始化組件時通過傳入?yún)?shù)來控制。默認是多選。在單選模式下可以傳入一個回調(diào)函數(shù)，即當選中某一好友時觸發(fā)。
整個組件最核心的部分是對事件的監(jiān)聽和對數(shù)據(jù)的異步獲取，組件涉及到了focus、blur、click、keyup，change 五個事件。我在代碼里面是把這五類事件分開放在不同的私有方法里面去綁定的。分別是： _clickBind();_focusBind();_blurBind(); _keyUpBind(); _selectChangeBind();
其中對input進行鍵盤事件的監(jiān)聽是最復雜的，要考慮到多種情況。通常沒輸入一個鍵都要去后臺請求一次數(shù)據(jù)，但需要對上下左右方向鍵和回車鍵做不同的處理，大家可以直接看源代碼來了解。
另外一個比較重要的處理就是重復選擇的好友會通過閃動顏色來提示。這里主要是通過setInterval()來實現(xiàn)
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的數(shù)組。
5.默認參數(shù)：
前面大部分參數(shù)主要是對DOM中對應的按鈕和容器進行指定 ，在大家不改變DOM結(jié)構(gòu)的前提下是不需要改動這些參數(shù)的。
/**
* 默認參數(shù)
* <pre>
* totalSelectNum 多選模式下，最多選取人數(shù)，默認為30
* selectType 選擇模式，默認為多選"multiple",若為單選，則用single
* selectCallBack 單選模式下，選中之后的回調(diào)函數(shù)。
* </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
};
6.調(diào)用方式：
在DOM結(jié)構(gòu)沒變的情況下，調(diào)用非常簡單。
var test = new giant.ui.friendsuggest();
當然，應該放在$(document).ready(function(){})里面，否則找不到對應的DOM。
如果需要修改參數(shù)，就查看上面的默認的參數(shù)，哪個需要改，就傳入哪個。
[Ctrl+A 全選 注:如需引入外部Js需刷新才能執(zhí)行]
打包下載
JavaScript技術(shù)：基于Jquery 好友選擇器V2.0，轉(zhuǎn)載需保留來源！
鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標記有誤，請第一時間聯(lián)系我們修改或刪除，多謝。
