自定义jQuery PickList插件 - 用法与实例(3)

PickList插件还有以下API方法：

 

setDefaults(options)

修改pickList的全局默认设置。

// 设置pickList插件的默认item_selector为"li.pickListItem"
// 设置pickList插件的默认selectedItemClassName为"highlight"
$.pickList.setDefaults({
item_selector : "li.pickListItem",
selectedItemClassName : "highlight"
});

 

initAvailableItems()

重新初始化availableList中的Item条目，为这些条目绑定事件回调；

var pl = $("#applicantPanel").pickList({
availableList_selector : "#editDlg_availableApplicantList",
pickedList_selector : "#editDlg_pickedApplicantList",
addButton_selector : "#editDlg_btnAddApplicant",
removeButton_selector : "#editDlg_btnRemoveApplicant"
});
// 一些操作....
pl.initAvailableItems();

initPickedItems()

重新初始化pickedList中的Item条目，为这些条目绑定事件回调；

addButton_click()

addButton被点击。availableList中的每一个被选中的条目，都分别会和pickedList中的所有条目比较(使用containsItem()比较)，如果containsItem()返回true，则pickedList中的相同的条目会加上"selectedItemClassName"定义的CSS样式；如果不返回true，则该条目会被移至pickedList。
 

removeButton_click()

removeButton被点击。pickedList中的每一个被选中的条目，都分别会和availableList中的所有条目比较(使用
containsItem()比较)，如果containsItem()返回true，则availableList中的相同的条目会加上"selectedItemClassName"定义的CSS样式；如果不返回true，则该条目会被移至availableList。
 

clearAvailableList()

清空availableList中的条目。返回当前PickList控件。

var pl = $("#applicantPanel").pickList({
availableList_selector : "#editDlg_availableApplicantList",
pickedList_selector : "#editDlg_pickedApplicantList",
addButton_selector : "#editDlg_btnAddApplicant",
removeButton_selector : "#editDlg_btnRemoveApplicant"
});
// 一些操作....
pl.clearAvailableList();

 

clearPickedList()

清空pickedList中的条目。返回当前PickList控件。
 

insertAvailableItems(html)

将包含新条目的HTML插入到availableList的DOM中。返回当前PickList控件。

var itemsHtml = "";
$.each(data.queryResult, function(i, n){
itemsHtml += "<li class='pickListItem'><span class='idCol'>" + n.id + "</span><span class='nameCol'>" + n.fullName + "</span></li>";
});
pl.clearAvailableList().insertAvailableItems(itemsHtml);

 

insertPickedItems(html)

将包含新条目的HTML插入到pickedList的DOM中。返回当前PickList控件。
 

getAvailableItems()

获得availableList中的所有条目，返回值为jQuery对象数组。
 

getPickedItems()

获得pickedList中的所有条目，返回值为jQuery对象数组。

if(pl.getPickedItems().size()<=0) {
result = "PickedList列表不能为空！/n";
return result;
}

 

getSelectedAvailableItems()

获得availableList中的所有处于选中状态的条目，返回值为jQuery对象数组。
 

getSelectedPickedItems()

获得pickedList中的所有处于选中状态的条目，返回值为jQuery对象数组。
 

getLastClickedAvailableItem()

获得availableList中的最近被点击的条目，返回值为jQuery对象。
 

getLastClickedPickedItem()

获得pickedList中的最近被点击的条目，返回值为jQuery对象。