自定义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对象。